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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



1 Scope 



This document specifies the stage 3 of the Open Service Architecture (OS A) Application Programming Interface (API). 
The concepts and the functional architecture of the Open Service Architecture (API) are described by TS 23. 127 [2]. 
This document describes the stage 3 specification of the Open Service Architecture API. 

The Open Service Architecture defines an architecture that enables service providers to make use of network 
functionality through an open standardised interface, i.e. the OSA API. The network functionality is describes as 
Service Capability Servers. Within the OSA concepts the following Service Capability Servers are identified: 

- CAMEL Service Environment (see in TS 23.078 [4]) 

- WAP execution platform (i.e. WAP Gateway & WAP Push Proxy, see in [13] ) 

- Home Location Register (HLR) 

The stage 3 documentation of the OSA R'99 API consists of two parts: 

- The API specification (Part 1). 

This is a normative stage 3 specification of the capabilities of the OSA R'99 API and describes the OSA API 
interface classes, containing class diagrams (see section 6), state transition diagrams (see section 7), SDLs (see 
section 8), data type definitions (section 9), and the IDLs (see section 10). 

- The Mapping specification of the OSA R'99 API and the network protocols (Part2). 

This is an informative specification to provide an example how the OSA API can be mapped on the network 
protocols (i.e. MAP [7], CAP[8] and WAP[9]). It is an informative document, since this mapping is considered 
as implementation/vendor dependent. On the other hand this mapping will provide potential service designers 
with a better understanding of the relationship of the OSA API interface classes and the behavior of the network 
associated to these interface classes. 

The OSA API Stage 3 activity is performed jointly with ETSI SPAN3's Service Provider Access Requirements activity. 
The contents of this document is related to the jointly owned 3GPP & ETSI document referred as the API Master 
document, which contains the API interface descriptions that are common and differentiated between ETSI & 3GPP. 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of this specification, the following definitions apply: 

Applications: Services, which are designed using service capability features. 

Gateway: Synonym for Service Capability Server. From the viewpoint of applications, a Service Capability Server can 
be seen as a gateway to the core network. 

HE-VASP: Home Environment Value Added Service Provider. This is a VASP that has an agreement with the Home 
Environment to provide services. 

Home Environment: responsible for overall provision of services to users 

Local Service: A service, which can be exclusively provided in the current serving network by a Value Added Service 
Provider. 

OS A Interface: Standardised Interface used by application to access service capability features. 

Personal Service Environment: contains personalised information defining how subscribed services are provided and 
presented towards the user. The Personal Service Environment is defined in terms of one or more User Profiles. 

Service Capabilities: Bearers defined by parameters, and/or mechanisms needed to realise services. These are within 
networks and under network control. 

Service Capability Feature: Functionality offered by service capabilities that are accessible via the standardised OS A 
interface 

Service Capability Server: Functional Entity providing OSA interfaces towards an application 

User Interface Profile: Contains information to present the personalised user interface within the capabilities of the 
terminal and serving network. 

User Profile: This is a label identifying a combination of one user interface profile, and one user services profile. 

User Services Profile: Contains identification of subscriber services, their status and reference to service preferences. 

Value Added Service Provider: provides services other than basic telecommunications service for which additional 
charges may be incurred. 

Virtual Home Environment: A concept for personal service environment portability across network boundaries and 
between terminals. 

Further definitions are given in TS 22.101 [5]. 
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3.2 



Abbreviations 



For the purposes of this TS the following abbreviations apply: 

CAMEL Customised Application For Mobile Network Enhanced Logic 

CSE Camel Service Environment 

HE Home Environment 

HE- V ASP Home Environment Value Added Service Provider 

HLR Home Location Register 

IDL Interface Description Language 

MAP Mobile Application Part 

ME Mobile Equipment 

MExE Mobile Station (Application) Execution Environment 

MS Mobile Station 

MSC Mobile Switching Centre 

OSA Open Service Architecture 

PLMN Public Land Mobile Network 

PSE Personal Service Environment 

SAT SIM AppHcation Tool-Kit 

SCP Service Control Point 

SIM Subscriber Identity Module 

SMS Short Message Service 

SMTP Simple Mail Transfer Protocol 

USIM User Service Identity Module 

VASP Value Added Service Provider 

VHE Virtual Home Environment 

WAP Wireless Application Protocol 

WGP Wireless Gateway Proxy 

WPP Wireless Push Proxy 

Further abbreviations are given in the TR 2L905 [1]. 
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Open Service Architecture 



The concepts and Architecture of the Open Service Architecture are described within [2]. Within this stage 2 document 
several Service CapabiHty Features are identified. However for OS A API Release 99, the set of addressed Service 
Capability Features are limited to the following: 

- Framework SCF 

- Service Discovery interface 

- Trust and Security Management interfaces (Initial Contact interfaces and Authentication interfaces) 

- Integrity Management interfaces (Load Manager interfaces, Fault Manager interfaces, 0AM interfaces. 
Heart Beat interfaces) 

- Registration interfaces 

- Call Control SCF 

- User Interaction SCFs 

- Generic User Interaction SCF 

- Call User Interaction SCF 

- Network User Location SCF 

- User Status SCF 

- Terminal Capabilities SCF 

- Data Session SCF 



The Framework API contains interfaces between the Application Server and the Framework, and between Network 
Service Capability Server (SCS) and the Framework. 

The User Profiles are limited to the Terminal Capabilities for OS A R'99. Therefore, only limited functionality is 
available for the security within OS A R'99. The Framework & Network SCSs provide the following security 
mechanisms for OS A R'99: 

- Checking the subscriber's registration to the SCS feature 

- Checking the subscriber's activation of the SCS feature 

- Checking the subscriber's privacy settings of the SCS feature 

The purpose of the OS A API is to shield the complexity of the network, its protocols and specific implementation from 
the applications. This means that applications do not have to be aware of the network nodes a Service Capability Server 
interacts with in order to provide the Service Capability Features to the application. The specific underlying network 
and its protocols are transparent to the application. 

For example, an application that has subscribed to the Network User Location SCF does not have to know whether the 
SCS provides location reports to the application based on information from the CSE or HLR. Similarly, the application 
does not have to know whether a message offered to the SCS for delivery to a terminal is actually sent by the SCS to the 
terminal via a WGPAVPP or SMS-C. It is the Service Capability Server that is capable of deciding how the message is 
to be sent. The OSA concept therefore leads to a shift of logic on dealing with the network from the applications to the 
Service Capability Servers. 
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Methodology 



Following is a description of the methodology used for the establishment of stage 3 specification in the scope of 3GPP 
CN OSA. 



5.1 Tools and Languages 



The Unified Modelling Language (UML) [14] is used as the means to specify class and state transition diagrams. 
Additionally, Object Management Group's (OMG) [15] Interface Definition Language (IDL) is used as the means to 
programmatically define the interfaces. IDL files are either generated manually from class diagrams or by using a UML 
tool. In the case IDLs are manually written and/or being corrected manually, correctness has been verified using a 
C0RBA2 (orbos/97-02-25) compHant IDL compiler, e.g. [13]. 

5.2 Packaging 

A hierarchical packaging scheme is used to avoid polluting the global name space. The root is defined as: 

org.threegpp.osa 

Note that the CORBA module hierarchy defined in the IDLs does not necessrly parallels the logical UML package 
hierarchy. 

5.3 Colours 

For clarity, class diagrams follows a certain colour scheme. Blue for application interface packages and yellow for all 
the others. 

5.4 Naming scheme 

The following naming scheme is used for both documentation and IDLs. 
packages 

lowercase. 

Using the domain-based naming (For example, org.threegpp.osa) 
classes, structures and types. Start with T 

TpCapitalizedWithlnternalWordsAlsoCapitalized 
Exception class: 

TpClassNameEndsWithException 
Interface. Start with Ip: 

IpThisIsAnlnterface 
constants: 

P_UPPER_CASE_WITH_UNDERSCORES_AND_START_WITH_P 
methods: 

firstWordLowerCaseButlnternalWordsCapitalizedO 
method's parameters 

firstWordLowerCaseButlnternalWordsCapitalized 
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collections (set, array or list types) 

TpCollectionEndsWithSet 
class/structure members 

FirstWordAndlnternalWordsCapitalized 
Spaces in between words are not allowed. 



5.5 



Error results 



As OMG IDL supports exception handling with high efficiency, OSA methods communicate errors in the form of 
CORBA exceptions of type TpGeneralException in the IDLs; the CORBA methods themselves always return void. But 
in the documentation, errors are communicated using a return parameter of type TpGeneralResult. 



5.6 



References 



In the interface specification whenever parameters are to be passed by reference, the "Ref ' suffix is appended to their 
corresponding data type (e.g. IpAnlnterfaceRef aninterface), a reference can also be viewed as a logical indirection. 
Therefore, structured or primitive data type passed as out parameters are references. An interface passed as an in 
parameter is also a reference but an interface passed as an out parameter is a double indirection (i.e.: RefRef) 



Original Data type 


IN parameter declaration 


OUT parameter declaration 


TpPrimitive 

TpStructured 

Iplnterface 


parm : IN TpPrimitive 
parm : IN TpStructured 
parm : IN IpInterfaceRef 


parm : OUT TpPrimitiveRef 
parm : OUT TpStructuredRef 
parm : OUT IpInterfaceRefRef 



In IDL, however, the following rules apply: 

- Interfaces are implicitly passed by reference. 

- out parameters are also implicitly passed by reference. 
This leads to: 

- Interface as an in parameter: Passed by Reference. 

- Structure or primitive type as an in parameter: Passed by Value. 

- Structure or primitive type as an out parameter: Passed by Reference. 

- Interface as an out parameter: As reference passed by reference. 

To simplify the documentation without adding ambiguities, parameters (interfaces, structures and primitive data types) 
are used as is when specified as in or out parameters in the IDL. This means that there will be no "Ref added after the 
data types of parameters in the IDL. 



5.7 Number of out parameters 



In order to support mapping to as many languages as possible, there is only 1 out parameter allowed per operation. 
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5.8 Strings and Collections 



For character strings, the String data type is used without regard to the maximum length of the string. In IDL, the data 
type String is typedefed^ from the CORB A primitive string. This CORB A primitive is made up of a length and a 
variable array of byte. 

For homogeneous collections of instances of a particular data type the following naming scheme is used: <datatype>Set. 
In OMG IDL, this maps to a sequence of the data type. A CORB A sequence is implicitly made of a length and a 
variable array of elements of the same type. 

Example: typedef sequence<TpSessionID> TpSessionlDSet; 

Collection types can be implemented (for example, in C++) as a structure containing an integer for the number part, 
and an array for the data part. 

Example: The TpAddressSet data type may be defined in C++ as: 

typedef struct { 

short number; 

TpAddress address []; 
} TpAddressSet; 



The array "address" is allocated dynamically with the exact number of required TpAddress elements based on 
"number". 

5.9 Prefixes 

OS A constants and data types are not defined in the global name space but in the org.threegpp.osa module. 

5.1 Naming space across CORBA modules 

The following shows the naming space used in this specification. 

module org { 

module threegpp { // cannot use 3gpp, names need to start with letter 
module osa { 



// The fully qualified name of the following constant 
// is org: : threegpp :: osa: :P_THIS_IS_AN_OSA_GLOBAL_CONST 
const long P_THIS_IS_AN_OSA_GLOBAL_CONST= 1999; 

// Add other OSA global constants and types here 

module framework { 

//no scoping required to access P_THIS_IS_AN_OSA_GLOBAL_CONST 



1 



A typedef IS a type definition declaration in IDL. 
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const long P_FW_CONST= THIS_IS_AN_OSA_GLOBAL_CONST; 

}; 

module mm { 

// scoping required to access P_FW_CONST 
const long P_M_CONST= framework :: P_FW_CONST; 

}; 



}; 
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Class diagrams 



Class diagrams are specified in UML: interface classes are shown as interface names within shaded rectangular boxes; 
relationships and generalizations as lines connecting pairs of interface classes. 

All OSA interface classes should be packaged into the org.threegpp.osa module. Further sub-packaging is an 
implementation decision, but this section proposes a way to do it. Using this recommended packaging, a top-down 
approach is followed in the subsequent sections. Note that UML packaging is only a logical packaging and does not 
necessarily reflects IDL packaging. 

6.1 Class diagrams common across OSA 

All application and framework interfaces inherit from IpOsa interface. Network Service Capability Features on the other 
hand inherit from the common IpService interface. The corresponding interfaces that must be implemented by the 
application (e.g. for API callbacks) are denoted as 'Application Interface'. 



«lnterface» 
IpOsa 

(from org.threegpp.osa) 



«lnterface» 
IpService 



%etCallback() 
Figure 6-1 : OSA base interfaces 

6.1.1 Base OSA interface 

All application and framework interfaces inherit from the following interface. 




6.1 .2 Generic Service Capability Feature interface 

All Network SCF's interfaces inherit from the following interface. 



«lnterface» 
IpService 



setGallback(applnterface : in IpOsaRef) : TpResult 
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6.2 Class diagrams for the Framework 

This section specifies the class diagrams that define the Framework, and proposes a way to package them. 

6.2.1 Top level Framework packages 

The top level view of the Framework consists of the following four packages: 



PAppFramework 



PFramework 



PFWFramework 



PSvcFramework 



Figure 6-2: Framework top level packages 

The first two packages are de-composed in the following way: 



PAppFramework 



Consists of 

• PappTmstAndSecurityMgmt 

• PAppIntegrityMgmt 



PFramework 



Consists of 

• PServiceDiscovery 

• PTmstAndSecurityMgmt 

• PIntegrityMgmt 



The latter two packages contain only one interface each: 

• PFWFramework consists of the Service Registration Interface 

• PSvcFramework consists of the Service Factory Interface 

The top-level packages are de-composed as described above; between some of the resulting sub-packages there are 
dependencies, that reflect dependencies between any two classes in the sub-package. The following figure shows all 
this. 
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PAppFramework 



PAppTrustAndSecurityMgmt 



PApplntegrityMgmt 



PFWFramework 



PSvcFramework 



PFramework 



PTrustAndSecurityMgmt 



PIntegrityMgmt 



PServiceDiscovery 



Figure 6-3: Framework sub-packages 



6.2.2 Service Discovery 



«lnterface» 
IpServiceDiscovery 



IistServiceTypesO 
JescribeServiceTypeO 
iiscoverServiceO 
*listSubscribedServices() 



Figure 6-4: Service Discovery Class Diagrams 



«lnterface» 
IpServiceDiscovery 



listServiceTypes(listTypes: out TpServiceTypeNameListRef) : TpResult 

describeServiceType(name: in TpServiceTypeName, serviceTypeDescription: out 
TpServiceTypeDescriptionRef) : TpResult 

discoverService(serviceTypeName: in TpServiceTypeName, desiredPropertyList: in TpServicePropertyList, 
max: in Tplnt32, serviceList: out TpServiceListRef) : TpResult 

listSubscribedServices(serviceList: out TpServiceListRef) : TpResult 
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6.2.3 Trust and Security Management 



«lnterface» 
Iplnitial 



^nitiateAuthenticationO 
^equestAccessO 



«lnterface» 
I pApp Access 



RignServiceAgreementO 
*ternninateServiceAgreement() 
■^erminateAccessO 



«lnterface» 
I p Access 



bbtainlnterfaceO 
DbtainlnterfaceWithCallbackO 
bccessCheckO 
pelectServiceO 
feignServiceAgreementO 
|erminateServiceAgreement() 
pndAccessO 



«lnterface» 
IpAppAuthentication 

^^uthenticateO 

I %bortAuthentication() 



«lnterface» 
IpAuthentication 



%electAuthMethod() 
%iuthenticate() 
^tbortAuthenticationO 



Figure 6-5: Trust and Security Management - Application and Framework Class Diagrams 
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6.2.3.1 Iplnitial 



«lnterface» 
Iplnitial 



inJtiateAuthentication(clientApplD: in TpClientAppID, authType : in TpAuthType, appAuthlnterface: 
in IpOsaRef, fwAuth Interface :out TpFwAuthRef) : TpResult 

request Access(accessType: in TpAccessType, app Access Interface; in IpOsaRef, 
fwAccess Interface: out IpOsaRef Ref): TpResult 



6.2.3.2 IpAppAuthentication 



«lnterface» 
IpAppAuthentication 



authenticate( prescribedMethod: in TpAuthCapability, challenge: in TpString, response: out 
TpStringRef) : TpResult 

abortAuthenticationO : TpResult 



6.2.3.3 IpAuthentication 



«lnterface» 
IpAuthentication 



selectAuthMethod (authCapability: in TpAuthCapabiltyList, prescribedMethod: out 
TpAuthCapabilityRef) : TpResult 

authenticate (prescribedMethod: in TpAuthCapability, challenge: in TpString, response: out 
TpStringRef) : TpResult 

abortAuthenticationO : TpResult 
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6.2.3.4 IpAccess 



«lnterface» 
IpAccess 



obtainlnterface( interfaceName: in TplnterfaceName, fwlnterface: out IpOsaRefRef): TpResult 

obtainlnterfaceWithCallback( interfaceName: in TplnterfaceName, applnterface: in IpOsaRef, 
fwlnterface: out IpOsaRefRef): TpResult 

accessCheck( securityContext:: in TpString, securityDomain: in TpString, group : in TpString, 
service AccessTypes: in TpString, serviceAccessControl: out TpServiceAccessControlRef): 
TpResult 

selectService( servicelD: in TpServicelD, serviceProperties: in TpServicePropertyList, 
serviceToken: out TpServiceTokenRef): TpResult 

signServiceAgreement( serviceToken: in TpServiceToken, agreementText: in TpString, 
signingAlgorithm: in TpSigningAlgorithm, signatureAndServiceMgr: out 
TpSignatureAndServiceMgrRef ): TpResult 

terminateServiceAgreement( serviceToken: in TpServiceToken, terminationText: in TpString, 
digitalSignature: in TpString): TpResult 

endAccess(endAccessProperties: in TpPropertyList) : TpResult 



6.2.3.5 IpAppAccess 



«lnterface» 
IpAppAccess 



signServiceAgreement( serviceToken: in TpServiceToken, agreementText: in TpString, 
signingAlgorithm: in TpSigningAlgorithm, digitalSignature: out TpStringRef): TpResult 

terminateServiceAgreement( serviceToken: in TpServiceToken, terminationText: in TpString, 
digitalSignature: in TpString): TpResult 

terminateAccess( terminationText: in TpString, signingAlgorithm: in TpSigningAlgorithm, 
digitalSignature: in TpStringRef) : TpResult 
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6.2.4 Integrity Management 



«lnterface» 
IpAppHeartBeatMgmt 



^nableAppHeartBeatO 
lli sabi eAppHeartBeat 
|;hangeTimePeriod() 



«lnterface» 
IpHeartBeatMgmt 1 



\ 



nableHeartBeatO 
lisableHeartBeatO 
ihangeTimePeriodQ 



«lnterface» 
0..* IpAppHeartBeat 



!send() 



«lnterface» 
0-' IpHeartBeat 

BendO 



«lnterface» 
I pAppLoad Manager 



^ueryAppLoadManagerO 

■^ueryLoadResO 

*queryLoadErr() 

■^di sabI eLoadControl () 

%nableLoadControl() 

'*VesumeNotification() 

, '*suspendNotif icationQ 



«lnterface» 
IpLoadManager 

J-eportLoadO 
-cjueryLoadReqO 
.queryAppLoadResO 
.queryAppLoadErrO 
j-egisterLoadControllerO 
nregisterLoadControllerO 
™>esumeNotification() 
^suspendNotificationQ 



«lnterface» 
IpAppFaultManager 

'^ctivityTestResO 
'^lappActivityTestReqO 
"^wFaultReportlndO 
"^wFault Recovery I nd () 
"^vcUnavailablelndO 
.J^^enPaultStatsRecordResO 



«lnterface» 
IpFaultManager 



I 



JactivityTestReqO 
appActivityTestResO 
^serviceUnavailablelndO 
genPaultStatsRecordReqO 



«lnterface» 
IpAppOAM 



■^systemDateTimeQueryO 

7K 



«lnterface» 
IpOAM 



IsystemDateTimeQueryO 



Figure 6-6: Integrity Management - Application and Framework Class Diagrams 



6.2.4.1 IpHeartBeatMgmt 



«lnterface» 
IpHeartBeatMgmt 



enableHeartBeat(duration: in TpDuration, applnterface: in IpAppHeartBeatRef, session: out 
TpSessionlDRef) : TpResult 

disableHeartBeat(session: in TpSessionID) : TpResult 
changeTimePeriod(duration: in TpDuration, session: in TpSessionID) : TpResult 



6.2.4.2 IpAppHeartBeatMgmt 



«lnterface» 
IpAppHeartBeatMgmt 



enableAppHeartBeat(duration: in TpDuration, fwlnterface: in IpHeartBeatRef, session: in 
TpSessionID) : TpResult 

disableAppHeartBeat(session: in TpSessionID) : TpResult 
changeTimePeriod(duration: TpDuration, session: in TpSessionID) : TpResult 
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6.2.4.3 IpHeartBeat 



«lnterface» 
IpHeartBeat 



send(session: in TpSessionID) : TpResult 



6.2.4.4 IpAppHeartBeat 



«lnterface» 
IpAppHeartBeat 



send(session: in TpSessionID) : TpResult 



6.2.4.5 IpLoadManager 



«lnterface» 
IpLoadManager 



reportLoad(requester : in TpClientAppID, loadLevel : in TpLoadLevel) : TpResult 

queryLoadReq(requester : in TpClientAppID, servicelDs: in TpServicelDList, timelnterval : in 
TpTimelnterval) : TpResult 

queryAppLoadRes(loadStatistics : in TpLoadStatisticList) : TpResult 

queryAppLoadErr(loadStatisticsError : in TpLoadStatisticErrorList) : TpResult 

registerLoadController( requester : in TpClientAppID, servicelDs: in TpServicelDList) : TpResult 

unregisterLoadController( requester : in TpClientAppID, servicelDs: in TpServicelDList) : TpResult 

resumeNotification(servicelDs: in TpServicelDList) : TpResult 

suspendNotification(servicelDs: in TpServicelDList) : TpResult 



ETSI 



3G TS 29.198 version 3.0.0 Release 1999 



27 



ETSI TS 129 198 V3.0.0 (2000-06) 



6.2.4.6 IpAppLoadManager 



«lnterface» 
IpAppLoadManager 



queryAppLoadReq(servicelDs: in TpServiceldList, timelnterval : TpTimelnterval) : TpResult 
queryLoadRes(loadStatistics : in TpLoadStatList) : TpResult 
queryLoadErr(loadStatisticsError : in TpLoadStatErrList) : TpResult 
disableLoadControl(servicelDs: in TpServiceldList) : TpResult 
enableLoadControl(loadStatistics : in TpLoadStatList ) : TpResult 
resumeNotificationO : TpResult 
suspendNotificationO : TpResult 



6.2.4.7 IpFaultManager 



«lnterface» 
IpFaultManager 



activityTestReq(activityTestlD: in TpActivityTestID, svcID: in TpServicelD, appID: in 
TpClientAppID): TpResult 

appActivityTestRes(activityTestlD: in TpActivityTestID, activityTestResult: in TpActivityTestRes): 
TpResult 

svcUnavailablelnd(servicelD: in TpServicelD, appID: in TpClientAppID): TpResult 

genFaultStatsRecordReq(timePeriod: in TpTimelnterval, servicelDList: in TpServicelDList, appID: 
in TpClientAppID): TpResult 



6.2.4.8 IpAppFaultManager 



«lnterface» 
IpAppFaultManager 



activityTestRes(activityTestlD: in TpActivityTestID, activityTestResult: in TpActivityTestRes): 
TpResult 

appActivityTestReq(activityTestlD: in TpActivityTestID): TpResult 

fwFaultReportlnd(fault: in TplnterfaceFault): TpResult 

fwFaultRecoverylnd(fault: in TplnterfaceFault): TpResult 

svcUnavailablelnd(servicelD: in TpServicelD, reason: in TpSvcUnavailReason): TpResult 

genFaultStatsRecordRes(faultStatistics: in TpFaultStatsRecord, servicelDs: in TpServicelDList): 
TpResult 



ETSI 



3G TS 29.198 version 3.0.0 Release 1999 



28 



ETSI TS 129 198 V3.0.0 (2000-06) 



6.2.4.9 IpOAM 



«lnterface» 
IpOAM 



system DateTimeQuery(clientDateAndTime : in TpDateAndTime, system DateAndTime: out 
TpDateAndTimeRef) : TpResult 



6.2.4.10 IpAppOAM 



«lnterface» 
IpAppOAM 



system DateTimeQuery(clientDateAndTime : in TpDateAndTime, system DateAndTime: out 
TpDateAndTimeRef) : TpResult 



6.2.5 Service Registration 



«lnterface» 
IpServiceRegistration 



registerServiceO 
announceServiceAvailabilityO 
unregisterServiceO 
describeServiceO 



Figure 6-7: Service Registration Class Diagram 



«lnterface» 
IpServiceRegistration 



registerService(serviceTypeName : in TpServiceTypeName, servicePropertyList : in TpServicePropertyList, 

servicelD : out TpServicelD) : TpResult 
announceServiceAvailability(servicelD : in TpServicelD, serviceFactoryRef : in IpOSA) : TpResult 
unregisterService(servicelD : in TpServicelD) : TpResult 
describeService(servicelD : in TpServicelD, serviceDescription : out TpServiceDescription) : TpResult 
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6.2.6 Service Factory 



«lnterface» 
IpSvcFactory 



getServiceManagerO 



Figure 6-8: Service Factory Class Diagram 



«lnterface» 
IpSvcFactory 



getServiceManager(application : in TpClientAppID, serviceManager : out IpOSA) : TpResult 



6.3 Generic Call Control 

The Generic Call Control SCF provides the basic call control capabilities for the API. It allows calls to be instantiated 
from the network and routed through the network. The call model is based around a central call model that has zero to 
two call legs that are active (i.e., being routed or connected), each of which represents the logical relationship between 
the call and an address. However, the application does not have direct access to the call legs. Generic Call Control 
supports functionality to allow call routing and call management for Camel Phase 3 and earlier services. 

Generic Call Control is represented by the IpCallManager and IpCall interfaces that interface to services provided by 
the network. Some methods are asynchronous, in that they do not lock a thread into waiting whilst a transaction 
performs. In this way, the client machine can handle many more calls, than one that uses synchronous message calls. To 
handle responses and reports, the developer must implement IpAppCallManager and IpAppCall. 



Pappgccs 



Pgccs 



Figure 6-9: Generic Call Control Packages 
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Figure 6-10: Generic Calf Control Class diagram Interface Classes 
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This section contains the detailed interface specifications of the interfaces shown in the Generic Call Control Class 
diagram. 

6.3.1 Interface Classes 
6.3.1 .1 IpAppCallControlManager 



«lnterface» 
IpAppCallControlManager 



callAborted(callReference : in TpSessionID) : TpResult 

callEventNotify(callReference : in TpCallldentifier , eventlnfo : in TpCallEventlnfo , assignmentID : in 
TpAssignmentID , applnterface : out IpAppCallRefRef) : TpResult 

callNotificationlnterruptedO : TpResult 

callNotificationContinued(): TpResult 



6.3.1 .2 IpCallControlManager 



«lnterface» 
IpCallControlManager 



enableCallNotification(applnterface : in IpAppCallControlManagerRef , eventCriteria : in 
TpCallEventCriteria , assignmentID : out TpAssignmentlDRef) : TpResult 

disableCallNotification(assignmentlD : in TpAssignmentID) : TpResult 

changeCallNotification(assignmentlD : in TpAssignmentID , eventCriteria : in TpCallEventCriteria) 
TpResult 

getCriteria(eventCriteria : out TpCallEventCriteriaResultSet) : TpResult 



6.3.1.3 IpAppCall 



«lnterface» 
IpAppCall 



routeRes(callSessionlD : in TpSessionID , eventReport : in TpCallReport, callLegSessionID : in 
TpSessionID) : TpResult 

routeErr(callSessionlD : in TpSessionID , errorlndication : in TpCallError, callLegSessionID : in 
TpSessionID) : TpResult 

getCalllnfoRes(callSessionlD : in TpSessionID , calllnfoReport : in TpCalllnfoReport) : TpResult 

getCalllnfoErr(callSessionlD : in TpSessionID , errorlndication : in TpCallError) : TpResult 

superviseCallRes(callSessionlD : in TpSessionID , report : in TpCallSuperviseReport , usedTime : in 
TpDuration) : TpResult 

superviseCallErr(callSessionlD : in TpSessionID , errorlndication : in TpCallError) : TpResult 

callFaultDetected(callSessionlD : in TpSessionID , fault : in TpCallFault) : TpResult 

callEnded(callSessionlD : in TpSessionID , report : in TpCallEndedReport ) : TpResult 



ETSI 



3G TS 29.198 version 3.0.0 Release 1999 



32 



ETSI TS 129 198 V3.0.0 (2000-06) 



6.3.1.4 IpCall 




routeReq(callSessionlD : in TpSessionID , responseRequested : in TpCallReportRequestSet , 

target Address : in TpAddress , originatingAddress : in TpAddress , originalDestinationAddress : in 
TpAddress , redirectingAddress : in TpAddress , applnfo : in TpCallApplnfoSet , callLegSessionID : out 
TpSessionlDRef ) : TpResult 

release(callSessionlD : in TpSessionID , cause : in TpCallReleaseCause) : TpResult 

deassignCall(callSessionlD : in TpSessionID) : TpResult 

getCalllnfoReq(callSessionlD : in TpSessionID , calllnfoRequested : in TpCalllnfoType) : TpResult 

setCallChargePlan(callSessionlD : in TpSessionID , callChargePlan : in TpCallChargePlan) : TpResult 

superviseCallReq(callSessionlD : in TpSessionID , time : in TpDuration , treatment : in 
TpCallSuperviseTreatment) : TpResult 

setAdviceOfCharge(callSessionlD : in TpSessionID , aOCInfo : in TpAoClnfo , tariffSwitch : in TpDuration) 
: TpResult 



6.4 



Generic User Interaction and Call User Interaction 



The Generic User Interaction interface and Call User Interaction SCFs are used by applications to interact with end 
users. 

The GUIS is represented by the IpUIManager, IpUI and IpUICall interfaces that interface to service 
capabilities provided by the network. 

The IpUI Interface provides functions to send information to, or gather information from the user, i.e. this interface 
allows applications to send SMS and USSD messages. An application can use this interface independently of other 
SCFs. The IpUICall Interface provides functions to send information to, or gather information from the user (or call 
party) attached to a call. 

To handle responses and reports, the developer must implement IpAppUIManager , IpAppUI and IpAppUICall 
interfaces to provide the callback mechanism. 




Figure 6-11: Generic User Interaction Packages 
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Figure 6-12: Generic User interaction Class diagram 

6.4.1 Relation between IpCall and IpUICall during call related user 
interaction 

For call related user interaction, the IpUICall Interface provides functions to send information to, or gather information 
from the user (or call party) attached to a call. This means that there is a relationship between a specific Call object and 
a UlCall object. This is shown in the figure below. 



«lnterface>> 
IpUICall 




«lnterface>> 
IpCall 


1 1 











Figure 6-13: Relation between the UlCall and the Call object. 
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In case a call requires user interaction, the application requests the UIManager to create the UlCall object and provides 
a reference to the specific Call object. In this way the gateway is able to link the two objects together. It depends on the 
actual state of the call whether user interaction is really allowed. 

6.4.2 Interface Classes 

This section contains the detailed interface specifications of the interfaces shown in the Generic User Interaction Class 
diagram. 

6.4.2.1 IpAppUIManager 



«lnterface» 
IpAppUIManager 



userlnteractionAborted(userlnteraction : in TpUlldentifier) : TpResult 

userlnteractionEventNotify(ui : in TpUlldentifier , eventlnfo : in TpUIEventlnfo , 

assignmentID : in TpAssignmentID , applnterface : out IpAppUIRefRef ) : TpResult 

userlnteractionNotificationlnterrupted(): TpResult 

userlnteractionNotificationContinued(): TpResult 



6.4.2.2 IpUIManager 



«lnterface» 
IpUIManager 



createUI(appUI : in IpAppUIRef , userAddress : in TpAddress , userlnteraction : out TpUlldentifierRef) 
TpResult 

createUICall(appUI : in IpAppUICallRef , callldentifier : in TpCallldentifier , 

callLegldentifier : in TpCallLegldentifier , userlnteraction : out TpUICallldentifierRef) : TpResult 

enableUINotification(applnterface : in IpAppUIManagerRef , 

eventCriteria : in TpUIEventCriteria , assignmentID : out TpAssignmentlDRef) : TpResult 

disableUINotification(assignmentlD : in TpAssignmentID) : TpResult 
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6.4.2.3 IpAppUl 



«lnterface» 
IpAppUl 



sendlnfoRes(userlnteractionSessionlD : in TpSessionID , assignmentID : in TpAssignmentID, 
response : in TpUIReport) : TpResult 

sendlnfoErr(userlnteractionSessionlD : in TpSessionID , assignmentID : in TpAssignmentID, 
error : in TpUIError) : TpResult 

sendlnfoAndCollectRes(userlnteractionSessionlD : in TpSessionID , assignmentID : in TpAssignmentID, 
response : in TpUIReport , info : in TpString) : TpResult 

sendlnfoAndCollectErr(userlnteractionSessionlD : in TpSessionID , assignmentID : in TpAssignmentID, 
error : in TpUIError) : TpResult 

userlnteractionFaultDetected(userlnteractionSessionlD : in TpSessionID , fault : in TpUIFault) : TpResult 
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6.4.2.4 IpUl 




sendlnfoReq(userlnteractionSessionlD : in TpSessionID , info : in TpUllnfo , 
variablelnfo : in TpUIVariablelnfoSet , repeatlndicator : in Tplnt32 , 

responseRequested : in TpUIResponseRequest , assignmentID : out TpAssignmentlDRef) : 
TpResult 

sendlnfoAndCollectReq(userlnteractionSessionlD : in TpSessionID , info : in TpUllnfo , 

variablelnfo : in TpUIVariablelnfoSet , criteria : in TpUICollectCriteria , responseRequested: in 
TpUIResponseRequest , assignmentID : out TpAssignmentlDRef) : TpResult 

release(userlnteractionSessionlD : in TpSessionID) : TpResult 



6.4.2.5 IpAppUICall 



«lnterface» 
IpAppUICall 



abortActionRes(userlnteractionSessionlD : in TpSessionID , assignmentID : in TpAssignmentID) 
TpResult 

abortActionErr(userlnteractionSessionlD : in TpSessionID , assignmentID : in TpAssignmentID , 
error : in TpUIError) : TpResult 



6.4.2.6 IpUICall 



«lnterface» 
IpUICall 



abortActionReq(userlnteractionSessionlD : in TpSessionID, assignmentID : in TpAssignmentID) 
TpResult 
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6.5 Data Session Control 

The Data Session Control provides a means to control per data session basis the establishment of a new data session. 
This means espcially in the GPRS context that the establishment of a PDP session is modelled not the attach/detach 
mode. Change of terminal location is assumed to be managed by the underlying network and is therefore not part of the 
model. The underlying assumption is that a terminal initiates a data session and the application can reject the request for 
data session establishment, can continue the establishment or can continue and change the destination as requested by 
the terminal. 

The modelling is hold similar to the Generic Call Control but assuming a simpler underlying state model. An 
IpDataSessionManager and IpData Session object are the interfaces used by the application, whereas the 
IpAppDataSessionManager and the IpAppDataSession interfaces are implemented by the application. 




Pdscs 



Figure 6-14: Data Session Control Packages 
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Figure 6-15: Data Session Control Class diagram Interface Classes 

This section contains the detailed interface specifications of the interfaces shown in the Data Session Control Class 
diagram. 

6.5.1 Interface Classes 



6.5.1 .1 IpAppDataSessionControlManager 



«lnterface» 
IpAppDataControlManager 



dataSessionAborted(dataSessionlD : in TpSessionID) : TpResult 

dataSessionEventNotify(dataSessionReference : in TpdataSessionldentifier , eventlnfo : in 
TpDataSessionEventlnfo , assignmentID : in TpAssignmentID , applnterface : out 
IpAppdataSessionRefRef) : TpResult 

dataSessionNotificationContinuedO : TpResult 

dataSessionNotificationlnterrupted(): TpResult 
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6.5.1 .2 IpDataSessionControlManager 



«lnterface» 
IpDataSessionControlManager 



enableDataSessionNotification(applnterface : in IpAppDataSessionControlManagerRef , eventCriteria : in 
TpDataSessionEventCriteria , assignmentID : out TpAssignmentlDRef) : TpResult 

disableDataSessionNotification(assignmentlD : in TpAssignmentID) : TpResult 



6.5.1 .3 IpAppDataSession 



«lnterface» 
IpAppDataSession 



connectRes(dataSessionlD : in TpSessionID , eventReport : in TpDataSessionEventReport, assignmentID 
: in TpAssignmentID) : TpResult 

connectErr(dataSessionlD : in TpSessionID , errorlndication : in TpDataSessionError, assignmentID : in 
TpAssignmentID) : TpResult 

superviseDataSessionRes(dataSessionlD : in TpSessionID , report : in TpDataSessionSuperviseReport, 
usedVolume : in TpDataSessionSuperviseVolume) : TpResult 

superviseDataSessionErr(dataSessionlD : in TpSessionID , errorlndication : in TpDataSessionError) : 
TpResult 

dataSessionFaultDetected(dataSessionlD : in TpSessionID , fault : in TpDataSessionFault) : TpResult 
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6.5.1.4 IpDataSession 



«lnterface» 
IpDataSession 



connectReq(dataSessionlD : in TpSessionID , responseRequested : in IpDataSession ReportRequestSet , 
targetAddress : in TpAddress , originatingAddress: in TpAddress, assignmentID : out TpAssignmentlDRef) 
: TpResult 

release(dataSessionlD : in TpSessionID , cause : in TpDataSessionReleaseCause) : TpResult 

superviseDataSessionReq(dataSessionlD : in TpSessionID, treatment : in 
TpDataSessionSuperviseTreatment , bytes : in TpDataSessionSuperviseVolume) : TpResult 

setDataSessionChargePlan(dataSessionlD: in TpSessionID, dataSessionChargePlan: in 
TpDataSessionChargePlan): TpResult 

setAdviceOfCharge(dataSessionlD : in TpSessionID, aoClnfo : in TpAoClnfo, tariffSwitch : in TpDuration): 
TpResult 
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6.6 



Network User Location 



The Network User Location (UL) SCF provides the IpUserLocat ionCamel interface, which provides methods for 
periodic and triggered location reporting. Most methods are asynchronous, in that they do not lock a thread into waiting 
whilst a transaction performs. In this way, the client machine can handle many more calls, than one that uses 
synchronous message calls. To handle responses and reports, the developer must implement 
IpAppUserLocat ionCamel interface to provide the callback mechanism. 
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Figure 6-16: Network User Location class diagram. 



6.6.1 Network User Location SCF interface 



This interface is the 'SCF manager' interface for Network User Location. 



«lnterface» 
IpUserLocationCamel 



locationReportReq(appLocationGamel : in IpAppUserLocationCamelRef, users : in TpAddressSet, 
assignmentid : out TpSessionlDRef) : TpResult 

periodicLocationReportingStartReq(appLocationGamel : in IpAppUserLocationCamelRef, users : in 
TpAddressSet, reportinglnterval : in TpDuration, assignmentid : out TpSessionlDRef) : TpResult 

periodicLocationReportingStop(stopRequest : in TpMobilityStopAssignmentData) : TpResult 

triggeredLocationReportingStartReq(appLocationCamel : in IpAppUserLocationCamelRef, users : in 
TpAddressSet, trigger : in TpLocationTriggerCamel, assignmentid : out TpSessionlDRef) : TpResult 

triggeredLocationReportingStop(stopRequest : in TpMobilityStopAssignmentData) : TpResult 
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6.6.2 Network User Location application interface 

The network user location application interface is implemented by the client application developer and is used to handle 
location reports that are specific for mobile telephony users. 



«lnterface» 
IpAppUserLocationCamel 



locationReportRes(assignnnentld : in TpSessionID, locations : in TpUserLocationCamelSet) : TpResult 

locationReportErr(assignmentld : in TpSessionID, cause : in TpMobilityError, diagnostic : in 
TpMobilityDiagnostic) 

periodicLocationReport(assignmentld : in TpSessionID, locations : in TpUserLocationCamelSet) : TpResult 

periodicLocationReportErr(assignmentld : in TpSessionID, cause : in TpMobilityError, diagnostic : in 
TpMobilityDiagnostic) 

triggeredLocationReport(assignmentld : in TpSessionID, location : in TpUserLocationCamel, criterion : in 
TpLocationTriggerCamel) : TpResult 

triggeredLocationReportErr(assignmentld : in TpSessionID, cause : in TpMobilityError, diagnostic : in 
TpMobilityDiagnostic) 



6.7 



User Status 



The User Status (US) SCF provides the IpUserStatus interface. Most methods are asynchronous, in that they do not 
lock a thread into waiting whilst a transaction performs. In this way, the client machine can handle many more calls, 
than one that uses synchronous message calls. To handle responses and reports, the developer must implement 
IpAppUserStatus interface to provide the callback mechanism. 
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Figure 6-17: User Status class diagram. 
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6.7.1 User Status SCF interface 

The user status interface represents the interface to the user status service capabiHty feature. 



«lnterface» 
IpUserStatus 



statusReportReq(appStatus : in IpAppUserStatusRef, users : in TpAddressSet, assignmentld : out 
TpSessionlDRef) : TpResult 

triggeredStatusReportingStartReq (appStatus : in IpAppUserStatusRef, users : in TpAddressSet, 
assignmentld : out TpSessionlDRef) : TpResult 

triggeredStatusReportingStop (stopRequest : in TpMobilityStopAssignmentData) : TpResult 



6.7.2 User Status application interface 



The user-status appHcation interface is implemented by the cHent appHcation developer and is used to handle user status 
reports. 



«lnterface» 
IpAppUserStatus 



statusReportRes(assignnnentld : in TpSessionID, status : in TpUserStatusSet) : TpResult 

statusReportErr(assignmentld : in TpSessionID, cause : in TpMobilityError, diagnostic : in 
TpMobilityDiagnostic) 

triggeredStatusReport(assignmentld : in TpSessionID, status : in TpUserStatus) : TpResult 

triggeredStatusReportErr(assignmentld : in TpSessionID, cause : in TpMobilityError, diagnostic : in 
TpMobilityDiagnostic) 



6.8 Terminal Capabilities 



The Terminal Capabilities SCF enables the application to retrieve the terminal capabilities of the specified terminal. 
The Terminal Capabilities service provides a SCF interface that is called IpTerminalCap abilities. There is no 
need for an application interface, since IpTerminalCapabilities only contains the synchronous method 

getTerminalCapabilities. 




Figure 6-18: Terminal Capabilities package 
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Figure 6-19: Terminal Capabilities class diagrams 



6.8.1 Terminal Capabilities SCF interface 

The Terminal Capabilities SCF interface IpTerminalCapabilities contains the synchronous method 
getTerminalCapabilities. The application has to provide the termina Identity is input to this method. 
The result indicates whether or not the terminal capabilities are available in the network and, in case they are, it will 
return the terminal capabilities (see the data definition of TpTerminalCapabilit ies for more information). 



«lnterface» 
IpTerminalCapabilities 



getTerminalCapabilities( 



terminalldentity : in TpString, 

Result : out TpTerminalCapabilities) : TpResult 
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State Transition Diagrams 



This section contains the State Transition Diagrams for the objects that implement the interfaces on the gateway side. 
The State Transition Diagrams show the behaviour of these objects. For each state the methods that can be invoked by 
the appHcation are shown. Methods not shown for a specific state are not relevant for that state and will return an 
exception. Apart from the methods that can be invoked by the application also events internal to the gateway or related 
to network events are shown together with the resulting event or action performed by the gateway. These internal events 
are shown between quotation marks. 
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Figure 7-1 : State Transition Diagram for Authentication 

7.1.1.1 Idle State 

When the application has requested the Iplnitial interface for initiate Authentication, an object implementing the 
IpAuthentication interface is created. The application now has to provide it's authentication capabilities by invoking the 
SelectAuthMethod method. 
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7.1 .1 .2 Init Authentication state 

In this state the Framework selects the preferred authentication mechanism within the capabiHty of the appHcation. 
When a proper mechanism is found, the Framework can decide that the appHcation doesn't have to be authenticated 
(one way authentication) or that the application has to be authenticated. In case no mechanism can be found the error 
code P_INVALID_AUTH_CAP ABILITY) is returned and the Authentication object is destroyed. This implies that the 
application has to re-initiate the authentication by calling once more the initiateAuthentication method on the Iplnitial 
interface. 

7.1 .1 .3 Wait For Application Result state 

When entering this state, the Framework requests the application to authenticate itself by invoking the Authenticate 
method on the application. In case the application requests the Framework to authenticate itself by invoking 
Authenticate on the IpAuthentication interface, the Framework provides the correct response to the challenge of the 
application. When the Framework responds to the Authenticate request, the response is analysed and in case the 
response is valid a transition to the state Application Authenticated is made. In case the response is not valid, the 
Authentication object is destroyed. This implicates that the application has to re-initiate the authentication by calling 
once more the initiateAuthentication method on the Iplnitial interface. 

7.1 .1 .4 Application Authenticated state 

In this state the application is considered authenticated and is now allowed to request access to the IpAccess interface. 
In case the application requests the Framework to authenticate itself by invoking Authenticate on the IpAuthentication 
interface, the Framework provides the correct response to the challenge of the application. 

7.1.2 IpAccess 



Iplnitial. re questAccess 



obtainlnterface/ return requested FW interface 

obtainlnterfaceWithCallback/ return requested FW interface 

accessCheck/ return whether application has access to requested service 
— \ 

selectService '^signServiceAgreement 

signServiceAgreement[ correct service selected ]/ get Service manager from Service Factory and return to application 

terminateServiceAgreement /destroy Service manager object 



network operator initiated endAccess /destroy all interface objects used by the application 
endAccess /destroy all interface objects used by the application 



Active 



Figure 7-2: State Transition Diagram for Access 



7.1.2.1 Active state 



When the application requestes access to the Framework on the Iplnitial interface, an object implementing the IpAccess 
interface is created. The application can now request other Framework interfaces, including Service Discovery. When 
the application is no longer interested in using the interfaces it calls the endAccess method. This results in the 
destruction of all interface objects used by the application. In case the network operator decides that the application has 
no longer access to the interfaces the same will happen. 
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7. 1 .3 IpServiceDiscovery 



obtainFrameworklnterface( discoveryService ) 
obtainlnterfaceWithCallback( discoveryService ) 

listServicpeTypes 

describeServiceType 

listSubscribedServices 
discover Service 




Active 



IpAcces 



Y 



s.endAccess 



Figure 7-3: State Transition Diagram for Service Discovery 

7.1.3.1 Active state 

When the application requests for the Service Discovery SCF by invoking the obtainlnterface or the 
obtainlnterfaceWithCallback methods on the Ip Access interface, an instance of the IpServiceDiscovery will be created. 
Next the application is allowed to request a list of the provided SCFs and to obtain a reference to interfaces of SCFs. 
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7.1.4 IpLoadManager 



registerLoadController 



unregisterLoadController 



/ 

IpAccessvobtain Interface 
lpAccess\obtain IryterfaceWilh Callback 

\\ I// 



IDLE 



unregisterLoadController 



-^ 



reportLoad 

\queryAppLoadRes[ load statistics requested by LoadManager ] 
queryAppLoadErr[ load statistics requested by LoadManager ] 

Registered ^ 



queryLoadReq 



queryLoad Err[ final load statistics report] 
queryLoadRes[final load statistics report] 



queryLoadReq 
reportLoad 



queryAppLoadRes[ load statistics requested by LoadManager ] 
queryAppLoadErr[ load statistics requested by LoadManager ] 



Notifying 



do/ obtain load statistics and report tin em at spec if led interval with queryLoad Res 



unregisterLoadController 



sumeNotification 




suspendNotification[ all notifications suspendend ] 



queryAppLoadRes[ load statistics requested by LoadManager] 
\ \i/ \|/ queryAppLoadErr[ load statistics requested by LoadManager ] 



IpAcces 



s.endAccess 



Figure 7-4: State Transition Diagram for LoadManager 

7.1.4.1 Idle State 

In this state the appHcation has obtained an interface reference of the LoadManager from the IpAccess interface. 

7.1.4.2 Registered State 

In this state the appHcation has registered for load control with the method RegisterLoadController(). The LoadManager 
can now request the application to supply load statistics information (by invoking query AppLoadReqO). Furthermore 
the LoadManager can request the application to control its load (by invoking enableLoadControl() or 
suspendNotificationO on the application side of interface). In case the application detects a change in load level, it 
reports this to the LoadManager by calling the method reportLoad(). 

When entering this state, an object called LoadManagerlnternal is created that has an internal state machine 
encapsulating the internal behaviour of the LoadManager. The State Transition Diagram of LoadManagerlnternal is 
shown in Figure . 

7.1.4.3 Notifying 

In the Notifying state the application has requested for load statistics. The Loadmanager gathers the requested 
information and (periodically) reports them to the application. 
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7.1 .4.4 Suspending Notification 

Due to e.g. a temporary load condition, the application has requested the LoadManager to suspend sending the load 
statistics information. 



A necessary action can ^ 
be suspending tlie load 
notifictions to tlie 
application or enabling 
load control mechanisms 
on certain services. 



reg is terLoadContr oiler 



report Load[ loadlevel != 



Normal load 




Application Overload 



reportLoad[ loadlevel = ] 



"internal load change detection" 
"internal load change to non overl(3aded" 



entry/ evaluate policy and perform necessary actions 
exit/cancel perform ed actions 



/"interrhal load change detection" 
"internal load change/o non oyerload" 



Internal overload 



entry/ evaluate policy and perform necessary actions 
exit/ cancel performed actions 



reportLoad[ loadlevel != ] 



Internal and Application Overload 

entry/ evaluate policy and perform necessary actions 
exit/ cancel performed actions 



reportLoad[ loadlevel = ] 



A_ 



A necessary action can be t^ 
suspending the load 
notifictions from the 
application by invoking 
suspendNotification or 
enabling load control 
mechanisms on the 
application by invoking 
enableLoad Control. 



ALL 
STATES 



unregisterLoadController 



X 



Figure 7-5: State Transition Diagram for the LoadManagerlnternal 

7.1 .4.5 Normal Load state 

In this state the none of the entities defined in the load balancing policy between the application and the framework / 
SCFs is overloaded. 

7.1 .4.6 Application overload state 

In this state the application has indicated it is overloaded. When entering this state the load policy is consulted and the 
appropriate actions are taken by the LoadManager. 

7.1 .4.7 Internal overload 

In this state the Framework or one or more of the SCFs within the specific load policy is overloaded. When entering this 
state the load policy is consulted and the appropriate actions are taken by the LoadManager. 
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7.1 .4.8 Internal and application overload 

In this state the appHcation is overloaded as well as the Framework or one or more of the SCFs within the specific load 
policy. When entering this state the load policy is consulted and the appropriate actions are taken by the LoadManager. 

7.1.5 IPFaultManager 

lpAccess.obtainFrameworklnterfaceWithCallback( "FaultManagement" ) / add application to fault management 

/ 'service fault' / '^serviceUnavailablelnd to all application using the service 

srvUnavailableInd / test the service, inform service that application is not using it 
genFaultStatsRecordReq '^app.genPaultStatsRecordRes 

no fault detected 




service fault '^srvUnavailableInd to all applications usingjbe-s §rvice 
activityTestRe€f[scflD] 



[CtivityTestReq [null] 



SVC ACTIVITY TEST 

entry/ test activity of services 
^ exit/ ^app,activityTestRes 




FW ACTIVITY TEST 



entry/ test activity of framework 
exit/ ^app.activityTestRes 



fault detected in fw 



IpAccess.end/iccess/ 



Abort pending 



test request 



fault detected in fw 



entry/ '^fwFaultReportlnd to all applications with callback 
^ exit/ ^fwFaultRecoverylnd to all applications with callback ^ 

Figure 7-6: State Transition Diagram for Fault Manager 

7.1.5.1 Framework Active state 

This is the normal state of the framework, which is fully functional and able to handle requests from both applications 
and services capability features. 

7.1 .5.2 Framework Faulty state 

In this state, the framework has detected an internal problem with itself such that application and services capability 
features cannot communicate with it anymore; attempts to invoke any methods that belongs to any SCFs of the 
framework returns an error. If the framework ever recover, application with fault management callbacks will be notified 
via a fwFaultRecoveryInd message. 

7.1 .5.3 The Service Activity Test state 

In this state, the framework is performing a test on one service capability feature. If the SCF is faulty, applications with 
fault management callbacks are notified accordingly through a svcUnavailableInd message. 

7.1 .5.4 The Framework Activity Test state 

In this state, the framework is performing self-diagnostic test. If a problem is diagnosed, all applications with fault 
management callbacks are notified through a fwFaultReportInd message. 
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7.1 .6 IpHeartbeatmgmt 




IpAccess. obtain Interface 
IpAccess.obtainlnterfaceWithCallback 



disableHeartBeat 



IpAccess.endAccess 



\ / \ / 
chanqeTimePeriod 



Application supervised 



Figure 7-7: State Transition Diagram for the Heartbeat manager 

7.1 .6.1 Application not supervised 

In this state the appHcation has not registered for heartbeat supervision by the Framework. 

7.1 .6.2 Application supervised 

In this state the appHcation has registered for heartbeat supervision by the Framework. Periodically the Framework will 
request for the application heartbeat by calling the send method on the IpAppHeartBeat interface. 
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7.1.7 IpHeartBeat 



lpAppHeartBeatMgmt.enableAppHeartBeat 



send /return heartbeat 




FW supervised by 
Application 



IpAppHeartBeatMgnt.disableAppHeartBeat 



\/ 



IpAccess.endAccess 



Figure 7-8: State Transition Diagram for HeartBeat 

7.1 .7.1 FW Supervised by Application state 

In this state the Framework has requested the appHcation for heartbeat supervision on itself. Periodically the application 
calls the send() method and the Framework returns it's heartbeat result. 

7.1.8 IpOAM 



IpAcces 5.obtainlnterface 
IpAccess.obtain Interface WitiiCaiiback 



system DateTlmeQuery 




Active 



IpAccess.endAccess 



Figure 7-9: State Transition Diagram for 0AM 
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7.1.8.1 Active state 

In this state the appHcation has obtained a reference to the IpOAM interface. The application is now able to request the 
date / time of the Framework. 



7. 1 .9. IpServiceRegistration 



registerService 



-^ 



registering SCF 



announceServiceAvailability 



[k 



describeService 
SCF registered 



unregisterService 



7.1.9.1 



Figure 7-10: State Transition Diagram for Service Registration 



Registering SCF 



This is the state entered when a Service Capability Server (SCS) starts the registration of its SCF in the Framework, by 
informing it of the existence of an SCF characterised by a service type and a set of service properties. As a result the 
Framework associates a service ID to this SCF, that will be used to identify it by both sides. When receiving this ID, the 
SCS instantiates a manager interface for this SCF, which will be the entry point for applications that want to use it. 



7.1.9.2 



SCF Registered 



This is the state entered when, the service manager interface having been instantiated, the SCS informs the Framework 
of the availability of the SCF, and makes it actually available by providing the Framework with the manager interfaces 
to be used by applications. Anytime the SCF availability may be withdrawn by un-registering it. 
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7.2 



Generic Call Control 



7.2.1 Call Control Manager 



"a call object has terminated abnormally '^IpAppCallControlMan age r.call Aborted 
"arrival of call related event"[ notification active for this call event]/ create a Call object '^IpAppCallControllVlanager.callEventNotify 
d is ableC all Notification, 
enableCallNotificatio 



^ 



Active 



Creation of ^ 

CallControlManager 

by Service Factory , 

I 1 / 

/ "' 

"notifications possible again' 
'^IpAppCallControllVlanager.callNotiicationContinued / 



TpAccess.terminateServiceAgreement 
notifications not possible" ^~~"^-^ 

Ip AppCallControl Man ager.call Notification Interrupted 

\ / lpAccess<terminateServiceAgreement 



\ disableCallNotification 

Kcall object has term in^iedab norm ally" '^IpAppCallControlManager.callAborted 



Notification terminated 



Figure 7-1 1 : State Transition Diagram for the CallControlManager 

7.2.1.1 Active state 

In this state a relation between the AppHcation and the Generic Call Control Service Capability Feature has been 
established. It allows the application to indicate that it is interested in call related events. In case such an event occurs, 
the Call Control Manager will create a Call object and inform the application by invoking the method callEventNotifyO 
on the IpAppCallControlManager interface. The application can also indicate it is no longer interested in certain call 
related events by calling disableCallNotification(). 

7.2.1 .2 Notification terminated state 

When the Call Control manager is in the Notification terminated state, events requested with enableCallNotification() 
will not be forwarded to the application. There can be multiple reasons for this: for instance it might be that the 
application receives more notifications than defined in the Service Level Agreement. Another example is that the SCS 
has detected it receives no notifications from the network due to e.g. a link failure. In this state no requests for new 
notifications will be accepted. 
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7.2.2 Call 



lpAppCalk>QntrolManager.callEventNotify 



etAdviceOfCharge 
superv iseCallReq 
getCalllnfoReq 
etCallChargePlan 



'disconnect from called party "[ monitoi 




getCalllnfoRes, superv iseCallR 



Jting aborted or invalid addre 
"connection to called party unsuccessf u r[ monitor mode = interrupt ] ^outeRe; 




"call ends : called party c 

"call ends: called party dis( 
"fault detected"! fault 



Network Released 



ng party arbandoned" ''callEnded 
ng part/ disconnects" ''callEnded 

ent ] \;allEnded, routeRes(party 
ts"[ no monitor for the event ] 'YiallEnded 

ed with networl< event ] 'YiallFaultDetectec 



[ no reports requested with getCalllnfoReq AND\ 

sup4rviseCalReq] dea^ni 




node = interrupt ] "routeRe; 



[ no reports requested wifh 
getCalllnfoReq MiD 
superviseCaJfReq ] 



iv ed for which was monitored "routeRe; 



"call supervision event" ''superv iseCallRes 



Application 
Released 



"requested it|formation ready" 
'^getCalllnfoRes, supervise Call Res 



In state Idle a timer mechanism should 
prevent that the object keeps occupying 
resources. In case the timer expires, the 
object should be destroyed and 
callFaultDetected should be reported to 
the application. 



Figure 7-12: State Transition Diagram for Call 



7.2.2.1 



Active state 



In this state a call between two parties is being setup or present. Refer to the substates for more details 

The application can request the gateway for a certain type of charging of the call by calling setCallChargePlan(). The 
application can request for charging related information by calling getCallInfoReq(). Furthermore the application can 
request supervision of the call by calling superviseCallReq(). It is also allowed to send Advice Of Charge information 
by calling setAdviceOfCharge(). 

7.2.2.1.1 1 Party in Call state 

When the Call is in this state a calling party is present. The application can now request that a connection to a called 
party be established by calling the method routeReq(). When the calling party abandons the call before the application 
has invoked the routeReqO operation, the gateway informs the application by invoking callFaultDetected() and also the 
operation callEnded() will be invoked. When the calling party abandons the call after the application has invoked 
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routeReqO but before the call has actually been established, the gateway informs the application by invoking 
callEnded(). 

When the calling party answers the call, a transition will be made to the 2 Parties in Call state. In case the call can not 
be established because the application supplied an invalid address or the connection to the called party was unsuccessful 
while the application was monitoring for the latter in interrupt mode, the Call object will stay in this state 

In this state user interaction is possible unless there is an outstanding routing request. 

7.2.2.1 .2 2 Parties in Call state 

A connection between two parties has been established. 

In case the calling party disconnects, the gateway informs the application by invoking callEnded(). 

When the called party disconnects different situations apply: 

1. the application is monitoring for this event in interrupt mode: a transition is made to the 1 Party in Call state, the 
application is informed with routeRes with indication that the called party has disconnected and all requested 
reports are sent to the application. The application now again has control of the call. 

2. the application is monitoring for this event but not in interrupt mode. In this case a transition is made to the 
Network Released state and the gateway informs the application by invoking the operation routeRes() and 
callEnded(). 

3. the application is not monitoring for this event. In this case the application is informed by the gateway invoking the 
callEndedO operation and a transition is made to the Network Released state. 

In this state user interaction is possible, but only when the application requested to be notified of the transition to this 
state in interrupt mode. After the user interaction is finished the gateway will automatically continue processing of the 
call. 

7.2.2.3 Network released state 

In this state the call has ended and the Gateway collects the possible call information requested with getCalllnfoReqO 
and / or superviseCallReq(). The information will be returned to the application by invoking the methods 
getCalllnfoResO and / or superviseCallRes() on the application. Also when a call was unsuccessful these methods are 
used.In case the application has not requested additional call related information immediately a transition is made to 
state Idle. 

7.2.2.4 Finished state 

In this state the call has ended and no call related information is to be send to the application. The application can only 
release the Call object. Calling the deassingCall() method has the same effect. Note that the application has to release 
the object itself as good 00 practice requires that when an object was created on behalf of a certain entity, this entity is 
also responsible for destroying it when the object is no longer needed. 

7.2.2.5 Application released state. 

In this state the application has requested to release the Call object and the Gateway collects the possible call 
information requested with getCallInfoReq(). In case the application has not requested additional call related 
information immediately the Call object is destroyed. 
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7.3 User Interaction 
7.3.1 Ul Manager 



"arrival of user initiated requestfor user interaction"[ notification active for this ui 
event] /create a Ul object '^IpAppUIIManager.userlnteractionEventNotify 



createUI /create Ul object 
createUICall /create UlCall object 




enableUINotification 
disableUINotification 



Active 



exit/ release Ul objects 



Creation of UIManager 
by Service Factory 



"notiifications not possible" '^userlnteractionNotificationlnterrupted 




Ip A cc es s . te rm irTErteS^ryic e Ag ree m e rit 




IpA ccess^jtemfTriateService Ag reem erit 



"notifications possible again" '^gserlntei/actionNotificationContinued 



disableUINotification 



Figure 7-13: State Transition Diagram for the UIManager 

7.3.1.1 Active state 

In this state a relation between the AppHcation and a User Interaction Service CapabiHty Feature (Generic User 
Interaction or Call User Interaction) has been established. The application is now able to request creation of UI 
and/orUICall objects. 



7.3.1.2. 



Notification Terminated state 



When the UI manager is in the Notification terminated state, events requested with enableUINotification() will not be 
forwarded to the application. There can be multiple reasons for this: for instance it might be that the application receives 
more notifications than defined in the Service Level Agreement. Another example is that the SCS has detected it 
receives no notifications from the network due to e.g. a link failure. In this state no requests for new notifications will 
be accepted. 
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7.3.2 Ul 



"requested message has been send" '^sendlnfoRes 
"user input received" '^sendlnfoAndCollectRes 

send Info And CollectReq 
sendlnfoReq 
IpUIManager. CreateUI 



"request to send irvfor^nation and collect a response unsuccessful" 
'^sentllnjoAndCollectErr 



'requestto send information unsucce^ful" '^sendlnfoErr 



Active 



'fault detected in the user inteTacJ[on" 
'^userlnteractionFaultDetected "" 



> 

IpAppUIManager.userinteractionEventNotify v 



T 



/ sendlnfoReq[final request] 

sendlnfoAndCollectReq[ final request ] 



release 




only send event ^ 
when requested 
by application 



requested message has been send"[ not final request] '^send Info Res 

'user input received "[ not final request] '^s end Info And CollaefRes 
'requestto send information and collecta response 
unsuccessfur'[ not final request] / 
'^sendlnfoAndCollectErr / 
"request to send information unsuccessful" '^sendlnfoErr 
"fault detected in the user intej:^tion"[ not 
final request] '^userlnteractionFaultDetected 



ived"[ final request] j^ndlnfoAndCollectRes 
sage has been send"[final request]'^sendlnfoRes 

tto send information and collect 
nse unsuccessfur'[ final request] 
'^s end Info AndCollectErr 

in the user interaction"[ final request ] '^userlnteractionFaultDetected 
d information unsuccessfur'[ final request] '^s end Info Err 



Figure 7-14: State Transition Diagram for Ul 

7.3.2.1 Active state 

In this state the Ul object is available for requesting messages to be send to the network. 

7.3.2.2 Release Pending state 

A transition to this state is made when the Application has indicated that after a certain message no further messages 
need to be send to the end-user. There are, however, still a number of messages that are not yet completed. When the 
last message is sent or when the last user interaction has been obtained, the Ul object is destroyed. 
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7.3.3 Ul Call 



'requested message has been send" '^sendlnfoRes 

"user input received" ''sendlnfoAndCollectRes -^ — 

'requestto send information and collecta response unsTJccessful" ''sendlnfoAndCollectErr 
"request to send information unsuccessful" ''sendlnfoErr — ^-^ 

"fault detected in the user interaction" ''userlnteractionFaultDetected 



send Info An dCollectReq 
sendlnfoReq 
IpUIManager.createUICall 



abortActionReq /cancel the user interaction 



sendlnfoReq[final request] 

s end lnfoAndCollectReq[ final request] 



at)ortActioH^q[ final request is aborted ] /cancel the user interaction 




only send event L\ 
when requested 
by application 



"abnormal end of useXinteraction" '^userlnteractionAbortect 
IpCall .release '^endlnfoXndCollectErr or sendlnfoErr 
l.deassignCall 



Report error on N 
all requested Ul 
for which result 
is expected. 



'requested message has been send"[ notfinal request] ')sendlnfoRes 
'user input received"[ not final request ] '^sendlnfoAndC/llectRes 

"requestto send information and collect a response unsuccessfur'[ notfinal request] 
'^s end Info AndCo^ectErr 

"requestto send information unsuccessful" ''sendlnfoErr 

"fault detected in the user interactioi/[ notfinal request] 
'^userlnteractionFaulpetected 



release 

"abnormal end of user interaction" '^u^erlnteractionAborted 
"user input received"[ final request]' '^sendlnfoAndCollectRes 
"requested message has been send"[ final request] ''sendlnfoRes 



It detected in the use 



:eraction"[ final request] ''userlnteractionFaultDetected 



"requestto send information and collecta response unsuccessfur'[ final request] 
'^sendlnfoAndCollectErr 

--~!Yequestto send information unsuccessfur'[ final request ] '^s end Info Err 
IpCall.deassignCall 
IpCaOeTease '^endlnfoAndCollectErr or sendlnfoErr 



Alternative to this ^ 
approach is one 
user interaction 
per object. 



Figure 7-15: State Transition Diagram for UlCall 



7.3.3.1 Active state 



In this state a UlCall object is available for announcements to be played to an end-user or obtaining information from 
the end-user. 

7.3.3.2 Release Pending state 

A transition to this state is made when the Application has indicated that after a certain announcement no further 
announcements need to be played to the end-user. There are, however, still a number of announcements that are not yet 
completed. When the last announcement is played or when the last user interaction has been obtained, the UlCall object 
is destroyed. 
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7.4 



Data Session 



IpAppDataSessionControlManaAer.dataSess 
ionEventNotify( P_EVENT_DSCB_SETUP ) 




party disconnects"n 
ion ends: party disconnects"! no 
unicated 





"ConnectR es(P_D ATA_SESSIO N_R E PORT_DISC ON N EC T) 



viseDataSessionRes 



_^4 

Application 
Released 



[ no reports requested^ith 
superviseDataSesgi^nReq ] 



lataSessionFaultDetected(P_DATA_SESSION_TIMEOUT_ON_RStASE) 



formation ready" 
perviseDataSession Res 



Instate Finis 


ed a timer mechanisrr 


should 


N 


prevent that t 


he object keeps occup 


ying 




resources. In 


case the timer expires 


the 




object should 


be destroyed and 






dataSessionF 


aultDetected should b 






reported to th 


aappication. 







Figure 7-16: State Transition Diagram for Data Session 



7.4.1 Active state 

In this state a data connection between two parties is being setup or established (refer to the substates for more details). 
The application can request the gateway for a certain type of charging by calling setDataSessionChargePlan(), send 
advice of charge information by calling setAdviceOfCharge(), and request supervision of the data session by calling 
superviseDataSessionReqO. 



7.4.1.1 



Setup state 



The Setup state is reached after a dataSessionEvebtNotifyO indicates to the application that a data session is interested 
in being connected. If the application is going to connect the two parties by invoking connectReqO it may call the 
charging or supervision methods before. 



7.4.1.2 



Established state 



In this state the data connection is established. If supervision has been requested the application expects the 
corresponding superviseDataSessionRes(). 
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7.4.2 Network Released state 

In this state the data session has ended. In the case on a normal user disconnection the transition to this state is indicated 
to the appHcation by the disconnect report of connectRes(). But this will only happen if the application requested 
monitoring of the disconnect event before. An abnormal disconnection is indicated by dataSessionFaultDetected(). The 
application may wait for outstanding superviseDataSessionRes(). 

7.4.3 Finished state 

In this state the data session has ended and no further data session related information is to be send to the application. 
The application can only release the data session object. If the application fails to invoke release() within a certain 
period of time the gateway should automatically release the object and send a timeout indication to the application. 

7.4.4 Application released state. 

In this state the application has released the data session object. If supervision has been requested the gateway will 
collect the information and send superviseDataRes() to the application. 
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7.5 



Network User Location 



"new" 




locationReportReq 

periodicLocationReportingStartReq 

periodicLocationReportingStop 

triggeredLocationReportingStartReq 

triggeredLocationReportingStop 



Active 



terminateServiceAgreement 



reation of User Locatiorf^ 
amel by Service Factory 



Figure 7-17: State Transition Diagram for Network User Location 

During the signService Agreement a new user location interface reference is created, which is user as the initial point of 
contact for the application. 

7.5.1 Active state 

In this state, a relation between the Application and the Network User Location Service Capability Feature has been 
established. It allows the application to request a specific user location reports, subscribe to periodic user location 
reports or subscribe to triggers that generate location report when a location update occurs inside the current VLR area 
or when the user moves to another VLR area or both. 



7.6 



User Status 



-> 




statusReportReq 

triggeredStatusReportingStartReq 

triggeredStatusReportingStop 



Active 



terminateServiceAgreement 



reation of User Status k^ 
ervice Factory 



Figure 7-18: State Transition Diagram for User Status. 
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7.6.1 Active State 

In this state, a relation between the AppHcation and the User Status Service CapabiHty Feature has been estabUshed. It 
allows the application to request a specific user status report or subscribe to triggers that generate status reports when 
the status of one of the monitored user changes. 



8 



Data Definitions 



8.1 



Common Data definitions 



The constants and types defined in the following sections are defined in the org.threegpp.osa package. 

8.1.1 Primitive Data Types 



^^^^^^H Type Nam^^^^^^^H 


^^^^^^^^^K DescriDtion ^^^^^^^^^^1 


k. 




TpBoolean 


Defines a Boolean data type. 


Tplnt32 


Defines a signed 32 bit integer. 


TpFloat 


Defines a single precision float 


TpString 


Defines a string, comprising length and data. 



8.1 .2 Structured data types classification 

Many different structured data types are used in OSA and a classification/clarification is required. 

8.1 .2.1 Structures made of data elements 

Tliis describes data types that can be considered as classes (in Java or C++) or structures (C++, IDL). The goal of these 
data types is to group pieces of information into a logical unit. Example : din TAddress data type may be defined in IDL 
as: 



struct TpAddress { 

TpAddressPlan 

TpString 

TpString 



Plan; 

AddrString; 
Name ; 



TpAddressPresentation Presentation; 
TpAddressScreening Screening; 
TpString SubAddressString; 



I.- 



S.I .2.2 Tagged choice of data elements (i.e.: Free unions) 

This describes a data type, which actually evaluates to one of a choice of a number of data elements. This data element 
contains two parts: a tag data type (the tag part) which is used to identify the chosen data type, and the chosen data type 
itself (the union part). This form of data type is also referred to as a tagged union. 

This data type can be implemented in IDL as a union with a switch statement for the tag part, and a set or case 
statements for the union part. 

Example: The TCallError data type may be defined in IDL as: 

union TpCallError switch (TCallErrorType) { 
case CALL ERROR UNDEFINED: 
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TpCallErrorlnfoDefault 
case CALL_ERROR_ROUTING_ABORTED: 

TpCallErrorInf oRoutingAborted 
case CALL_ERROR_CALL_ABANDONED : 

TpCallErrorlnfoCallAbandoned 
case CALL_ERROR_INVALID_ADDRESS: 

TpCallErrorInf oInvalidAddress 
case CALL_ERROR_INVALID_STATE: 

TpCallErrorlnfoDefault 
case CALL_ERROR_INVALID_CRITERIA: 

TpCallErrorlnfoDefault 



Cal IE rrorUnde fined; 



CallErrorRoutingAborted; 



CallErrorCallAbandoned; 



CallErrorlnvalidAddress; 



CallErrorlnvalidState; 



CallErrorlnvalidCriteria; 



}; 



8.1 .2.3 Collection of data elements 

This describes a data type, which comprises an ordered or unordered collection of data elements of the same type. The 
number of data elements in the collection is always know and can be implicit (IDL) or may appear as an integer inside a 
structure depending on the language used. This data type can be implemented in IDL as a sequence. 



Example: 



typedef sequence<SessionID> SessionlDSet ; 



8.1.2.4 References 

This describes a reference (or pointer) to a data type. This is primarily used to describe 'out' method parameters. 

This data type may be implemented (for example, in C++) as a pointer. However, in some languages it may not be 
necessary for 'out' parameters to be implemented as pointers. 

Example: The TAddressRef data type may be defined in C++ as: 

typedef TAddress '^TAddressRef; 

8.1 .3 Interface Definitions 

8.1.3.1 ipOsa 

Defines the address of an IpOsa Interface. 

8.1.3.2 IpOsaRef 

Defines a Reference to type IpOsa 

8.1.3.3 IpOsaRefRef 

Defines a Reference to type IpOsaRef 

8.1.3.4 IpService 

Defines the address of an IpService Interface. 
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8.1.3.5 IpServiceRef 

Defines a Reference to type IpService 

8.1.3.6 IpServiceRefRef 

Defines a Reference to type IpServiceRef 

8.1 .4 Non primitive and structured type types definition 

8.1 .4.1 TpAssignmentID 

This data type is identical to a Tplnt32. It specifies a number which identifies an individual event notification enabled 
by the application or OSA service capability feature. 

8.1.4.2 TpSessionID 

Defines a network unique session ID. OSA uses this ID to identify sessions within an object implementing an interface 
capable of handling multiple sessions. For the different OSA service capability features, the sessionlDs are unique only 
in the context of a manager instantiation (e.g., within the context of one generic call control manager). As such if an 
application creates two instances of the same SCF manager it shall use different instantiations of the callback objects 
which implement the callback interfaces. 

The session ID is identical to a Tplnt32 type. 

8.1.4.3 TpSessionlDSet 

Defines a collection of data elements of TpSessionID. 



8.1.4.4 TpDuration 

This data type is a Tplnt32 representing a time interval in milliseconds. A value of "-1" defines infinite duration and 
value of "-2" represents default duration. 

8.1.4.5 TpResult 

Defines the structure of data elements that specifies the result of a method call. 







ResultType 


TpResultType 


ResultFacility 


TpResultFacility 


Resultlnfo 


TpResultlnfo 



8.1.4.6 TpResultType 

Defines whether the method was successful or not. 



piB, 




1 


Descriptioi 


i 


P_RESULT_FAILURE 





Method failed 


P_RESULT_SUCCESS 


1 


Method was successful 
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8.1.4.7 TpResultFacility 

Defines the facility code of a result. In Release 99 of the OS A API, only P_RESULT_FACILITY_UNDEFINED must 
be used. 



1 kkUJiI^ 


^ffiTfffP 


llJJJdllllliMlF 




rP_RESULT_FACILITY_UNDEFINED 





Undefined 



8.1.4.8 TpResultlnfo 

Defines further information relating to the result of the method, such as error codes. 



1 l£^^9 




1 


Descriptioi 










P_RESULT_INFO_UNDEFINED 


OOOOh 


No further information present 


P_INVALID_APPLICATION_ID 


OOOlh 


InvaHd appHcation ID 


P_INVALID_CLIENT_CAP ABILITY 


0002h 


InvaHd cHent capabiHty 


P_INVALID_AGREEMENT_TEXT 


0003h 


InvaHd agreement text 


P_INVALID_SIGNING_ALGORITHM 


0004h 


InvaHd signing algorithm 


P_INVALID_INTERFACE_ID 


0005h 


Invalid interface ID 


P_INVALID_SERVICE_ID 


0006h 


InvaHd service capabiHty feature ID 


P_INVALID_EVENT_TYPE 


0007h 


Invalid event type 


P_SERVICE_NOT_ENABLED 


0008h 


The service capability feature ID does not correspond to a SCF that 
has been enabled 


P_INVALID_ASSIGNMENT_ID 


0009h 


The assignment ID does not correspond to one of the valid 
assignment IDs 


P_INVALID_PARAMETER 


000 Ah 


The method has been called with an invalid parameter 


P_INVALID_PARAMETER_VALUE 


OOOBh 


A method parameter has an invalid value 


P_P ARAME T E R_M I S S I NG 


OOOCh 


A required parameter has not been specified in the method call 


P_RE SOURCE S_UNAVAILABLE 


OOODh 


The required resources in the network are not available 


P_TASK_REFUSED 


OOOEh 


The requested method has been refused 


P_TASK_CANCELLED 


OOOFh 


The requested method has been cancelled 


P_INVALID_DATE_TIME_FORMAT 


OOlOh 


Invalid date and time format provided 


P_NO_CALLBACK_ADDRESS_SET 


001 Ih 


The requested method has been refused because no callback 
address is set 


P_INVALID_TERMINATION_TEXT 


0012h 


Invalid termination text 


P_INVALID_SERVICE_TOKEN 


0013h 


The service capability feature token does not correspond to a token 
that had been issued, or the issued token has expired 


P_INVALID_AUTHENTICATION 


0014h 


The cHent has not been correctly authenticated 


P_INVALID_SERVICE_PROPERTY 


0015h 


InvaHd service capabiHty feature property 


P_METHOD_NOT_SUPPORTED 


OOlBh 


The method is not allowed or supported within the context of the 
current SCF agreement. 


W General security errors 1 


P_USER_NOT_SUBSCRIBED 


0030h 


A service (or application) is unauthorised to access information and 
request SCFs with regards to users that are not subscribed to it. 


P_APPLICATION_NOT_ACTIVATED 


003 Ih 


A service (or application) is unauthorised to access information and 

request SCFs with regards to its subscribed users that have 

deactivated that particular service (or appHcation). 


P_USER_PRIVACY 


0032h 


A service (or appHcation) is unauthorised to access information and 

request an SCF with regards to its subscribed users that have set 

their privacy flag regarding that particular SCF. 


I 






P_GCCS_SERVICE_INFORMATION_MISSING 


OlOOh 


Information relating to the CaU Control SCF could not be found 


P_GCCS_SERVICE_FAULT_ENCOUNTERED 


OlOlh 


Fault detected in the CaU Control SCF 


P_GCCS_UNEXPECTED_SEQUENCE 


0102h 


Unexpected sequence of methods, i.e., the sequence does not match 
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the specified state diagrams for the call or the call leg. 


P_GCCS_INVALID_ADDDRESS 


0103h 


Invalid address specified 








P_GCCS_INVALID_CRITERIA 


0105h 


Invalid criteria specified 


P_GCCS_INVALID_NETWORK_STATE 


0106h 


Although the sequence of method calls is allowed by the OS A 
gateway, the underlying protocol can not support it. 

E.g., in some protocols some methods are only allowed by the 

protocol, when the call processing is suspended, e.g., after reporting 

an event that was monitored in interrupt mode. 














P_GUIS_INVALID_CRITERIA 


0300h 


InvaHd criteria specified 


P_GUIS_ILLEGAL_ID 


0301h 


Information id specified is invaUd 


P_GUIS_ID_NOT_FOUND 


0302h 


A legal information id is not known to the User Interaction SCF 


P_GUIS_ILLEGAL_RANGE 


0303h 


The values for minimum and maximum collection length are out of 
range. 


P_GUIS_INVALID_COLLECTION_CRITERIA 


0304h 


Invalid collection criteria specified 








P_GUIS_INVALID_NETWORK_STATE 


0306h 


Although the sequence of method calls is allowed by the OS A 
gateway, the underlying protocol can not support it. 

E.g., in some protocols some methods are only allowed by the 

protocol, when the call processing is suspended, e.g., after reporting 

an event that was monitored in interrupt mode. 


P_GUIS_UNEXPECTED_SEQUENCE 


0307h 


Unexpected sequence of methods, i.e., the sequence does not match 
the specified state diagrams. 








P_DSCS_SERVICE_INFORMATION_MISSING 


0400h 


Information relating to the Data Session Control SCF could not be 
found 


P_DSCS_SERVICE_FAULT_ENCOUNTERED 


0401h 


Fault detected in the Data Session Control SCF 


P_DSCS_UNEXPECTED_SEQUENCE 


0402h 


Unexpected sequence of methods, i.e., the sequence does not match 
the specified state diagrams for the data session. 


P_DSCS_INVALID_ADDDRESS 


0403h 


Invalid address specified 


P_DSCS_INVALID_STATE 


0404h 


Invalid state specified 


P_DSCS_INVALID_CRITERIA 


0405h 


InvaHd criteria specified 


P_DSCS_INVALID_NETWORK_STATE 


0406h 


Although the sequence of method calls is allowed by the OS A 
gateway, the underlying protocol can not support it. 



8.1.4.9 TpDate 

This data type is identical to a TpString. It specifies the data in accordance with International Standard ISO 8601. This 
is defined as the string of characters in the following format: 

YYYY-MM-DD 

where the date is specified as: 

YYYY four digits year 
MM two digits month 

DD two digits day 

The date elements are separated by a hyphen character (-). 

Example: 

The 4 December 1998, is encoded as the string: 

1998-12-04 
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8.1.4.10 TpTime 

This data type is identical to a TpString. It specifies the time in accordance with International Standard ISO 8601. This 
is defined as the string of characters in the following format: 

HHiMMiSS.mmm 

or 

HHiMMiSS.nunmZ 

where the time is specified as: 

HH two digits hours (24h notation) 

MM two digits minutes 

SS two digits seconds 

mmm three digits fractions of a second (i.e. milliseconds) 

The time elements are separated by a colon character ( : ).The date and time are separated by a space. Optionally, a 
capital letter Z may be appended to the time field to indicate Universal Time (UTC). Otherwise, local time is assumed. 

Example 

For local time, 10:30 and 15 seconds is encoded as the string: 

10:30:15.000 
or in UTC it would be: 

10:30:15. OOOZ 

8.1.4.11 TpDateAndTime 

This data type is identical to a TpString. It specifies the data and time in accordance with International Standard ISO 
8601. This is defined as the string of characters in the following format: 

HH:MM:SS.mmm 

or 

YYYY-MM-DD HH :MM: SS .mmmZ 

where the date is specified as: 

YYYY four digits year 
MM two digits month 

DD two digits day 

The date elements are separated by a hyphen character (-). 

The time is specified as: 

HH two digits hours (24h notation) 

MM two digits minutes 

SS two digits seconds 

mmm three digits fractions of a second (i.e. milliseconds) 

A colon character separates the time elements ( : ). The date and time are separated by a space. Optionally, a capital 
letter Z may be appended to the time field to indicate Universal Time (UTC). Otherwise, local time is assumed. 

Example 

The 4 December 1998, at 10:30 and 15 seconds is encoded as the string: 

10:30:15.000 
for local time, or in UTC it would be: 

10:30:15. OOOZ 
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8.1.4.12 TpAddress 

Defines the structure of data elements that specifies an address. 

















uruciure ivieinDer i>ame 




1 


:!>iruciure iviemoer lyp 


1 


Plan 


TpAddressPlan 


AddrString 


TpString 


Name 


TpString 


Presentation 


TpAddressPresentation 


Screening 


TpAddress Screening 


SubAddressString 


TpString 



8.1.4.13 TpAddressSet 

Defines a collection of TpAddress elements. 

8.1.4.14 TpAddressPlan 

Defines the address plan (or numbering plan) used. It is also used to indicate whether an address is actually defined in a 
Address data element. 



^^ ^^^^ 


lvalue 1 




Description 




P_ADDRESS_PLAN_NOT_PRESENT 


-1 


No Address Present 


P_ADDRESS_PLAN_UNDEFINED 





Undefined 


P_ADDRESS_PLAN_IP 


1 


IP 


P_ADDRESS_PLAN_MULTICAST 


2 


Multicast 


P_ADDRESS_PLAN_UNICAST 


3 


Unicast 


P_AD D RE S S_P L AN_E 164 


4 


E.164 


P_ADDRESS_PLAN_E164_MOBILE 


5 


E. 164 Mobile 


P_ADDRESS_PLAN_AESA 


6 


AESA 


P_ADDRESS_PLAN_URL 


7 


URL 


P_ADDRESS_PLAN_NSAP 


8 


NSAP 


P_ADDRESS_PLAN_SMTP 


9 


SMTP 








P_ADDRESS_PLAN_X4 


11 


X.400 



8.1.4.15 TpAddressPresentation 

Defines whether an address can be presented to an end user. 









P_ADDRESS_PRESENTATION_UNDEFINED 





Undefined 


P_ADDRESS_PRESENTATION_ALLOWED 


1 


Presentation Allowed 


P_ADDRESS_PRESENTATION_RESTRICTED 


2 


Presentation Restricted 


P_ADDRESS_PRESENTATION_ADDRESS_NOT_AVAILABLE 


3 


Address not available for presentation 
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8.1.4.16 TpAddressRange 

This type is identical to Tp Address with the difference that the AddrString can contain wildcarts. 

Two wildcards are allowed: * which matches zero or more characters and ? which matches exactly one character. The 
wildcards are only allowed at the end or at the beginning of the addrString. 

Some examples for El 64 addresses: 

• "123" matches specified number. 

• "123*" matches all numbers starting with 123 (including 123 itself). 

• "123??*" matches all numbers starting with 123 and at least 5 digits long. 

• "123???" matches all numbers starting with 123 and exactly 6 digits long 



For e-mail style addresses, the wildcards can be used at the beginning of the addrString: 

• *@ 3gpp.org matches all email addresses in the 3gpp.org domain. 
The following address ranges are illegal: 

• 1?3 

• 1*3 

• ?123* 

8.1.4.17 TpAddressScreening 

Defines whether an address has been screened by the application. 



^^^^H 


^^^Ql 




Description, 










P_ADDRESS_SCREENING_UNDEFINED 





Undefined 


P_ADDRESS_SCREENING_USER_VERIFIED_PASSED 


1 


user provided address 
verified and passed 


P_ADDRESS_SCREENING_USER_NOT_VERIFIED 


2 


user provided address 
not verified 


P_ADDRESS_SCREENING_USER_VERIFIED_FAILED 


3 


user provided address 
verified and failed 


P_ADDRESS_SCREENING_NETWORK 


4 


Network provided address 



8.1.4.18 TpAddressError 

Defines the reasons why an address is invahd. 



^ li^i 










1 


» Description ■ 




P_ADDRESS_INVALID_UNDEFINED 





Undefined error 


P_ADDRESS_INVALID_MISSING 


1 


Mandatory address not present 


P_ADDRESS_INVALID_MISSING_ELEMENT 


2 


Mandatory address element not present 


P_ADDRE S S_INVAL ID_OUT_OF_RANGE 


3 


Address is outside of the valid range 


P_ADDRESS_INVALID_INCOMPLETE 


4 


Address is incomplete 


P_ADDRESS_INVALID_CANNOT_DECODE 


5 


Address cannot be decoded 
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8.1.4.19 TpURL 

This data type is identical to a TpString and contains a URL address. The usage of this type is distinct of TpAddress, 
which can also hold an URL. The latter contains a user address which can be specified in many ways: IP, mail, URL, 
X.300, El 64. On the other hand, the TpURL type does not hold the address of a user and always represents a URL. This 
type is used in user interaction and defines the URL of the text or stream to be sent to an end-user. It is therefore 
inappropriate to use a general address here. 

8.1.4.20 TpPrice 

This data type is identical to a TpString. It specifies price information, which is used in user interaction when an 
announcement is being played and additional information is given to the user. This is defined as the string of characters 
(digits) in the following format: 

DDDDDD . DD 

8.1.4.21 TpAoClnfo 

Defines the Sequence of Data Elements that specify the Advice Of Charge information to be sent to the terminal. 



Sequence Element Namd 




j 


kjuence Element T 






Description ' 




ChargeOrder 


TpAoCOrder 


Charge order 


Currency 


TpString 


Currency unit according to ISO- 
4217:1995 



8.1.4.22 TpAoCOrder 

Defines the Tagged Choice of Data Elements that specify the charge plan for the call. 



1 


^H Tag Element TvDe ^H 








TpAoCOrderCategory 





'^^^^Tag Element Value 




"WSfWfl 


e Element Ty 

1 


r 




loice Element Na 


^^a 


P_CHARGE_ADVI CE_INFO 


TpChargeAdvicelnfo 


ChargeAdvicelnfo 


P_CHARGE_PER_TIME 


TpChargePerTime 


ChargePerTime 


P_CHARGE_NETWORK 


TpString 


NetworkCharge 



8.1.4.23 TpCallAoCOrderCategory 



^^^HH 










i*j^^ 


■ Description ■ 


«--^ii. 


P_CHARGE_ADVICE_INFO 





Set of GSM Charge Advice Information elements 
according to 3GTS 22.024 


P_CHARGE_PER_TIME 


1 


Charge per time 


P_CHARGE_NETWORK 


2 


Operator specific charge plan specification, e.g. 
charging table name / charging table entry 



8.1 .4.24 TpChargeAdvicelnfo 

Defines the Sequence of Data Elements that specify the two sets of Advice of Charge parameters. The first set defines 
the current tariff. The second set may be used in case of a tariff switch in the network. 
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L 


Sequence Element Nam 




, 


uence Element T 


i 

\ 


J 


Description 




CurrentCAI 


TpCAIElements 


Current tariff 


NextCAI 


TpCAIElements 


Next tariff after tariff switch 



8.1.4.25 TpCAIElements 

Defines the Sequence of Data Elements that specify theCharging Advice Information elements according to 3G TS 

22.02 4. 



^^L ^pniipnrp Flpmpnt Nnm^^^H 


LSeauence Element Tyoe J 


WSSSmun^M 


1 




Unit sPer Interval 


Tplnt32 


Units per interval 


SecondsPer Time Interval 


Tplnt32 


Seconds per time interval 


ScalingFactor 


Tplnt32 


Scaling factor 


Unitlncrement 


Tplnt32 


Unit increment 


Unit sPerDat a Interval 


Tplnt32 


Units per data interval 


SegmentsPerDatalnteral 


Tplnt32 


Segments per data interal 


InitialSecsPer Time Interval 


Tplnt32 


Initial sees per time interval 



8.1.4.26 TpChargePerTime 

Defines the Sequence of Data Elements that specify the time based charging information. 



Sequence Element Name 

■ 




] 


uence Element T 


? , 


^1 


Description """"""""""iiiiiiiiin"^"' 


InitialCharge 


Tplnt32 


Initial charge amount (in currency 
units * 0.0001) 


Cur rent Char gePerMinute 


Tplnt32 


Current tariff (in currency units 
^ 0.0001) 


Next Char gePerMinute 


Tplnt32 


Next tariff (in currency units * 
0.0001) after tariff switch 

Only used in setAdviceOf Charge ( ) 



8.2 



Framework Data Definitions 



This section provides the framework specific data definitions necessary to support the OSA interface specification. 

This document is written using Hypertext link, to aid navigation through the data structures. Underlined text represents 
Hypertext links. 

The general format of a data definition specification is the following: 

- Data type, that shows the name of the data type. 

- Description, that describes the data type. 

- Tabular specification, that specifies the data types and values of the data type. 

- Example, if relevant, shown to illustrate the data type. 

8.2.1 Common Framework Data Definitions 
8.2.1.1 TpClientAppID 

This is an identifier for the client application. It is used to identify the client to the framework. This data type is 
identical to TpString and is defined as a string of characters that uniquely identifies the application. The content of this 
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string shall be unique for each OS A API implementation (or unique for a network operator's domain). This unique 
identifier shall be negotiated with the OSA operator and the application shall use it to identify itself. 

8.2.1.2 TpClientApplDList 

This data type defines a Numbered Set of Data Elements of type TpClientAppID. 

8.2.1.3 TpEntOpID 

This data type is identical to TpString and is defined as a string of characters that identifies an enterprise operator. In 
conjunction with the application it uniquely identifies the enterprise operator which uses a particular OSA Service 
Capability Feature. 

8.2.1.4 TpEntOplDList 

This data type defines a Numbered Set of Data Elements of type TpEntOpID. 

8.2.1.5 TpService 

This data type is a Sequence of Data Elements which describes a registered SCFs. It is a structured type which consists 
of: 



^^ Sequence Elemer 

■ 






lequence Elemen 

■ 1 


; 




icumentation 






















ServicelD 


TpServicelD 




ServicePropertyList 


TpServicePropertyList 





8.2.1.6 TpServiceList 

This data type defines a Numbered Set of Data Elements of type TpService. 

8.2.1 .7 TpServiceDescription 

This data type is a Sequence of Data Elements which describes a registered SCF. It is a structured data type which 
consists of: 



Sequence Elemer 
Name 


( 




' Sequence Element 
1 Type 


1 




■ Documentation 


1 


ServiceTypeName 


TpServiceTypeName 




ServicePropertyList 


TpServicePropertyList 





8.2.1.8 TpServicelD 

This data type is identical to a TpString, and is defined as a string of characters that uniquely identifies an instance of a 
SCF interface. The string is automatically generated by the Framework, and comprises a TpUniqueServiceNumber, 
TpServiceNameString, and a number of relevant TpServiceSpecString, which are concatenated using a forward 
separator (/) as the separation character. 

8.2.1.9 TpServicelDList 

This data type defines a Numbered Set of Data Elements of type TpServicelD. 

8.2.1.10 TpServicelDRef 

Defines a Reference to type TpServiceld. 



ETSI 



3G TS 29.198 version 3.0.0 Release 1999 



74 



ETSI TS 129 198 V3.0.0 (2000-06) 



8.2.1 .1 1 TpServiceNameString 

This data type is identical to a TpString, and is defined as a string of characters that uniquely identifies the name of an 
SCF interface. Other Network operator specific capabilities may also be used, but should be preceded by the string 
"SP_".The following values are defined for OSA release 99. 





I^^^Her String Vafl^ 


1 




Descript^ff 


1 


NULL 


An empty (NULL) string indicates no SCF name 


P_CALL_CONTROL 


The name of the Call Control SCF 


P_USER_INTERACTION 


The name of the User Interaction SCFs 


P_TERMINAL_CAP ABILITIES 


The name of the Terminal Capabilities SCF 


P_USER_LOCATION 


The name of the Network User Location SCF 


P_USER_STATUS 


The name of the User Status SCF 


P_DATA_SESSION_CONTROL 


The name of the Data Session Control SCF 



8.2.1.12 TpServiceSpecString 

This data type is identical to a TpString, and is defined as a string of characters that uniquely identifies the name of an 
SCF specialisation interface. Other network operator specific capabilities may also be used, but should be preceded by 
the string "SP_".The following values are defined for OSA release 99. 



k 


Character String Vall^ 


1 




'Description ' 




NULL 


An empty (NULL) string indicates no SCF specialisation 


P_CALL 


The Call specialisation of the of the User Interaction SCF 



8.2.1 .13 TpUniqueServiceNumber 

This data type is identical to a TpString, and is defined as a string of characters that represents a unique number that is 
used to build the service ID (refer to TpServicelD). 

8.2.1.14 TpPropertyStruct 

This data type is a Sequence of Data Elements which describes an SCF property. It consists of: 



•^^^■■Sequence Elemeri^B 
I^^^^^^H Name ^^^^m 


1 


i 


^^Sequence Elemen^^B 
^^ Type ^^. 


1 




1 Documentation 

■ 






ServicePropertyName 


TpServiceTypeName 




ServicePropertyMode 


TpServicePropertyMode 




ServicePropertyTypeName 


Tp S ervic ePr op ertyTyp eName 





8.2.1 .15 TpPropertyStructList 

This data type defines a Numbered Set of Data Elements of type TpPropertyStruct. 
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8.2.1.16 TpServicePropertyMode 

This type is left as a placeholder but is not used in release 99. This defines SCF property modes. 



jm^ 


jn^ 










Liocumenianoi 


1 


NORMAL 





The value of the corresponding SCF property type may optionally be 
provided 


MANDATORY 


1 


The value of the corresponding SCF property type must be provided at 
service registration time 


READONLY 


2 


The value of the corresponding SCF property type is optional, but once 
given a value it may not be modified 


MANDATORY_READONLY 


3 


The value of the corresponding SCF property type must be provided 
and subsequently it may not be modified. 



8.2.1 .17 TpServicePropertyTypeName 

This data type is identical to TpString and describes a valid SCF property name. The valid SCF property names are 
listed in the SCF data definition. 

8.2.1.18 TpServicePropertyName 

This data type is identical to TpString. It defines a valid SFC property name. Valid SCF property names are listed in 
the SCF data definition. 

8.2.1.19 TpServicePropertyNameList 

This data type defines a Numbered Set of Data Elements of type TpServicePropertyName. 

8.2.1 .20 TpServicePropertyValue 

This data type is identical to TpString and describes a valid value of a SCF property. The valid SCF property values are 
given in the SCF data definition. 

8.2.1 .21 TpServicePropertyValueList 

This data type defines a Numbered Set of Data Elements of type TpServicePropertyValue 

8.2.1 .22 TpServiceProperty 

This data type is a Sequence of Data Elements which describes an "SCF property". It is a structured data type which 
consists of: 



^^Sequence Element 

Name i 






Sequence Elemen 
■ Tvoe 






1 Documentation 










i 












Service? rope rtyName 


TpServicePropertyName 




ServicePropertyValueLis 

t 


TpServicePropertyValueList 




ServicePropertyMode 


TpServicePropertyMode 





8.2.1 .23 TpServicePropertyList 

This data type defines a Numbered Set of Data Elements of type TpServiceProperty. 
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8.2.1 .24 TpServiceTypeDescription 

This type is left as a placeholder but is not used in release 99. 

This data type is a Sequence_of_Data_Elements which describes an SCF type. It is a structured data type. It consists of: 



Sequence Eleirn 
Name 


1 


1 


Sequence Elemen 
Type J 


1 


1 


Documentation H 


, 


PropertyStructList 


TpPropertyStructList 


a sequence of property name and property mode 
tuples associated with the SCF type 


ServiceTypeNameList 


TpServiceTypeNameList 


the names of the super types of the associated SCF 
type 


EnabledOrDisabled 


TpBoolean 


an indication whether the SCF type is enabled or 
disabled 



8.2.1 .25 TpServiceTypeName 

This data type is identical to TpString and describes a valid SCF type name. 

8.2.1 .26 TpServiceTypeNameList 

This data type defines a Numbered Set of Data Elements of type TpServiceTypeName. 

8.2.2 Trust and Security Management Data Definitions 
8.2.2.1 TpAccessType 

This data type is identical to a TpString. This identifies the type of access interface requested by the client application. 
If they request P_ACCESS, then a reference to the IpAccess interface is returned. (Network operators can define their 
own access interfaces to satisfy client requirements for different types of access. These can be selected using the 
TpAccessType, but should be preceded by the string "SP_". The following values are defined for OS A release 99: 



' 


Value ^^^^^^^^^^^B 




3escription 












NULL 


An empty (NULL) string indicates the default access type 


P_ACCESS 


Access using the OS A Access Interfaces: IpAccess and 
IpAppAccess 



8.2.2.2 TpAuthType 

This data type is identical to a TpString. It identifies the type of authentication mechanism requested by the client. It 
provides Network operators and client's with the opportunity to use an alternative to the OSA Authentication interface, 
e.g. CORBA Security. OSA Authentication is the default authentication method. Other Network operator specific 
capabilities may also be used, but should be preceded by the string "SP_". The following values are defined for OSA 
release 99: 



m i 


String Value 


1 


1 


^Description ' 


1 


NULL 


An empty (NULL) string indicates the default 
authentication method: OSA Authentication. 


P_AUTHENTICATION 


Authenticate using the OSA Authentication Interfaces: 
IpAuthentication and IpAppAuthentication 
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8.2.2.3 TpAuthCapability 

This data type is identical to a TpString, and is defined as a string of characters that identify the authentication 
capabiHties that could be supported by the OSA. Other Network operator specific capabilities may also be used, but 
should be preceded by the string "SP_". Capabilities may be concatenated, using commas (,) as the separation 
character. The following values are defined for OSA release 99. 





String Valu^ 






Descript^P 


1 


NULL 


An empty (NULL) string indicates no client capabilities. 


P_DES_5 6 


A simple transfer of secret information that is shared 

between the client application and the framework with 

protection against interception on the link provided by the 

DBS algorithm with a 56bit shared secret key 


P_RSA_512 


A pubHc-key cryptography system providing authentication 
without prior exchange of secrets using 512 bit keys 


P_RSA_102 4 


A public -key cryptography system providing authentication 
without prior exchange of secrets using 1024bit keys 



8.2.2.4 TpAuthCapabilityList 

This data type is identical to a TpString. It is a string of multiple TpAuthCapability concatenated using a comma (,)as 
the separation character. 

8.2.2.5 TplnterfaceName 

This data type is identical to a TpString, and is defined as a string of characters that identify the names of the framework 
SCFs that are be supported by the OSA API. Other Network operator specific SCFs may also be used, but should be 
preceded by the string "SP_".The following values are defined for OSA release 99. 





Character String Value 






Description 




NULL 


An empty (NULL) string indicates no interface. 


P_DISCOVERY 


The name for the Discovery interface. 


P_OAM 


The name for the OA&M interface. 


P_TRUST_AND_SECURITY_MANAGEMENT 


The name for the Trust and Security Management interface 


P_INTEGRITY_MANAGEMENT 


The name for the Integrity Management interface. 



8.2.2.6 TpServiceAccessControl 

This is Sequence of Data Elements containing the access control policy information controlling access to the service 
capability feature, and the trustLevel that the Network operator has assigned to the client application. 



ijjijjjBJiJlllijji 


^^^myiiii^MyiuHiiH^JIjI^K 


Policy 


TpString 


TrustLevel 


TpString 



The policy parameter indicates whether access has been granted or denied. If granted then the parameter trustLevel 
must also have a value. 

The trustLevel parameter indicates the trust level that the Network operator has assigned to the client application. 

8.2.2.7 TpServiceToken 

This data type is identical to a TpString, and identifies a selected SCF. This is a free format text token returned by the 
framework, which can be signed as part of a service agreement. This will contain Network operator specific information 
relating to the service level agreement. The serviceToken has a limited lifetime, which is the same as the lifetime of the 
service agreement in normal conditions. If something goes wrong the serviceToken expires, and any method accepting 
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the serviceToken will return an error code (P_INVALID_SERVICE_TOKEN). Service Tokens will automatically 
expire if the client or framework invokes the endAccess method on the other's corresponding access interface. 

8.2.2.8 TpSignatureAndServiceMgr 

This is a Sequence of Data Elements containing the digital signature of the framework for the service agreement, and a 
reference to the SCF manager interface of the SCF. 



! 


Sequence Element Name 




1 


Sequence Element Typ 


r 














Digital Signature 


TpStringRef 


ServiceMgr Inter face 


IpServiceRef 



The digitalSignature is the signed version of a hash of the service token and agreement text given by the client 
application. 

The ServiceMgrlnterface is a reference to the SCF manager interface for the selected SCF. 

8.2.2.9 TpSigningAlgorithm 

This data type is identical to a TpString, and is defined as a string of characters that identify the signing algorithm that 
must be used. Other Network operator specific capabilities may also be used, but should be preceded by the string 
"SP_". The following values are defined for OS A release 99. 



1^ 


String Value 

1 1 


I 


1 


^Description ' 


1 


NULL 


An empty (NULL) string indicates no signing algorithm is 
required 


P_MD5_RSA_512 


MD5 takes an input message of arbitrary length and 
produces as output a 128-bit message digest of the input. 
This is then encrypted with the private key under the RSA 

public-key cryptography system using a 512 bit key. 


P_MD5_RSA_102 4 


MD5 takes an input message of arbitrary length and 

produces as output a 128-bit message digest of the input. 

This is then encrypted with the private key under the RSA 

public- key cryptography system using a 1024 bit key 



8.2.3 Integrity Management Data Definitions 
8.2.3.1 TpActivityTestRes 

This type is identical to TpString and is an implementation specific result. The values in this data type are "Available" 
or "Unavailable". 



8.2.3.2 TpFaultStatsRecord 

This defines the set of records to be returned giving fault information for the requested time period. 



Sequence Element Name ^^^H 


^^f Sequence Element Type * 


L 


Period 


TpTime Interval 


FaultRecords 


TpFaultStatsSet 



8.2.3.3 TpFaultStatsSet 

This defines the sequence of data elements which provide the statistics on a per fault type basis. 



Sequence Element Name 


Sequence Element Type 


Fault 


TpInterfaceFault 


Occurrences 


Tplnt32 
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MaxDuration 


Tplnt32 


TotalDuration 


Tplnt32 


NumberOf Client sAffected 


Tplnt32 



Occurrences is the number of separate instances of this fault during the period. MaxDuration and 
TotalDuration are the number of seconds duration of the longest fault and the cumulative total during the 
period. NumberOfClientsAffected is the number of clients informed of the fault by the framework. 

8.2.3.4 TpActivityTestID 

This data type is identical to a Tplnt32, and is used as a token to match activity test requests with their results.. 

8.2.3.5 TplnterfaceFault 

Defines the cause of the interface fault detected. 



1 Q^^^f 






Description, 










INTERFACE_FAULT_UNDEFINED 





Undefined 


INTERFACE_FAULT_LOCAL_FAILURE 


1 


A fault in the local API software or hardware 
has been detected 


INTERFACE_FAULT_GATEWAY_FAILURE 


2 


A fault in the gateway API software or 
hardware has been detected 


INTERFACE_FAULT_PROTOCOL_ERROR 


3 


An error in the protocol used on the client- 
gateway link has been detected 



8.2.3.6 TpSvcUnavailReason 

Defines the reason why a SCF is unavailable. 



mm 


^^^Ql 




Description 










SERVICE_UNAVAILABLE_UNDEFINED 





Undefined 


SERVICE_UNAVAILABLE_LOCAL_FAILURE 


1 


The Local API software or hardware has failed 


SERVICE_UNAVAILABLE_GATEWAY_FAILURE 


2 


The gateway API software or hardware has 
failed 


SERVICE_UNAVAILABLE_OVERLOADED 


3 


The SCF is fully overloaded 


SERVICE_UNAVAILABLE_CLOSED 


4 


The SCF has closed itself (e.g. to protect from 
fraud or malicious attack) 



8.2.3.7 TpAPIUnavailReason 

Defines the reason why the API is unavailable. 



1 icg^H 


"^^3F 




Description 










API_UNAVAILABLE_UNDEFINED 





Undefined 


API_UNAVAILABLE_LOCAL_FAILURE 


1 


The Local API software or hardware has failed 


AP I_UNAVAILABLE_GATEWAY_FAILURE 


2 


The gateway API software or hardware has 
failed 


AP I_UNAVAILABLE_OVERLOADED 


3 


The gateway is fully overloaded 


AP I_UNAVAILABLE_CLOSED 


4 


The gateway has closed itself (e.g. to protect 
from fraud or maUcious attack) 


API_UNAVAILABLE_PROTOCOL_FAILURE 


5 


The protocol used on the cHent-gateway Hnk 
has failed 
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8.2.3.8 TpLoadLevel 

Defines the Sequence of Data Elements that specify load level values. 



wmjT^m 


mm 








\ 


uescripiion i 




LOAD_LEVEL_NORMAL 





Normal load 


LOAD_LEVEL_OVERLOAD 


1 


Overload 


LOAD_LEVEL_SEVERE_OVERLOAD 


2 


Severe Overload 



8.2.3.9 TpLoadThreshold 

Defines the Sequence of Data Elements that specify the load threshold value. The actual load threshold value is 
application and SCF dependent, so is their relationship with load level. 



j 


Sequence Element Name 






Sequence Element Typ 




LoadThreshold 


TpFloat 1 



8.2.3.10 TpLoadlnitVal 

Defines the Sequence of Data Elements that specify the pair of load level and associated load threshold value. 



^^^^^^^^^fceauence Element Name ^^^^^^^^1 


^^^^ft Seouence Element Tvn^^^^^^l 


1 




LoadLevel 


TpLoadLevel 


LoadThreshold 


TpLoadThreshold 



8.2.3.11 TpTimelnterval 

Defines the Sequence of Data Elements that specify a time interval. 





ence Element Na 


] 


1 


quence Element 
















StartTime 


TpDateAndTime 


StopTime 


TpDateAndTime 



8.2.3.12 TpLoadPolicy 

Defines the load balancing policy. 

















ence i^iemeni rNS 


i 




pquence Jiiemeni 


1 


LoadPolicy 


TpString 



8.2.3.13 TpLoadStatistic 

Defines the Sequence of Data Elements that specify the load statistic record at given timestamp. 















i 


>equence r^iemeni i>iame 




1 


sequence r^iemeni i yp 




ServicelD 


TpServicelD 


LoadValue 


TpFloat 


LoadLevel 


TpLoadLevel 


Time St amp 


TpDateAndTime 



LoadValue is expressed in percentage. 
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8.2.3.14 TpLoadStatList 

Defines a Numbered Set of Data Elements of TpLoadStatistic. 

8.2.3.15 TpLoadStatusError 

Defines the error code for getting the load status. 



BEEB 


WEsm 


1 


Description 






iT'TVr-r'T 




LOAD_STATUS_ERROR_UNDEFINED 





Undefined error 


LOAD_STATUS_ERROR_UNAVAILABLE 


1 


Unable to get the load status 



8.2.3.16 TpLoadStatisticError 

Defines the Sequence of Data Elements that specify the error for getting the load status at given timestamp. 



^H 


Sequence Element Name 






Sequence Element Type 


1 


ServicelD 


TpServicelD 


LoadStatusError 


TpFloat 


Time St amp 


TpDateAndTime 



8.2.3.1 7 TpLoadStatisticErrorList 

Defines a Numbered Set of Data Elements of TpLoadStatisticsError. 



8.3 



Generic Call Control Data Definitions 



The constants and types defined in the following sections are defined in the org.threegpp.osa.gccs package. 



8.3.1 



Interface definitions 



8.3.1.1 IpAppCall 

Defines the address of an lAppCall Interface. 

8.3.1.2 IpAppCallRef 

Defines a Reference to type lAppCall 

8.3.1.3 IpAppCallRefRef 

Defines a Reference to type lAppCallRef . 

8.3.1 .4 IpAppCallControlManager 

Defines the address of an lAppCallControlManager Interface. 

8.3.1 .5 IpAppCallControlManagerRef 

Defines a Reference to type lAppCallControlManager. 

8.3.1.6 IpCall 

Defines the address of an I Call Interface. 



ETSI 



3G TS 29.1 98 version 3.0.0 Release 1 999 82 ETSI TS 1 29 1 98 V3.0.0 (2000-06) 

8.3.1.7 IpCallRef 

Defines a Reference to type I Call. 

8.3.1.8 IpCallRefRef 

Defines a Reference to type ICallRef . 

8.3.1 .9 IpCallControlManager 

Defines the address of an ICallControlManager Interface.' 

8.3.1.10 IpCallControlManagerRef 

Defines a Reference to type ICallControlManager. 

8.3.2 Event Notification data definitions 
8.3.2.1 TpCallEventName 

Defines the names of events being notified with a new call request. The following events are supported. The values may 
be combined by a logical 'OR' function when requesting the notifications. Additional events that can be requested / 
received during the call process are found in the TpCallReportType data-type. 



1 fSSSS 


wm 




P_EVENT_NAME_UNDEF INED 





Undefined 


P_EVENT_GCCS_OFFHOOK_EVENT 


1 


GCCS - Offhook event. 

This can be used for hot-line features. In case 
this event is set in the TpCallEventCriteria, 
only the originating address(es) may be 
specified in the criteria. 


P_EVENT_GCCS_ADDRESS_COLLECTED_EVENT 


2 


GCCS - Address information collected 

The network has collected the information 
from the calling party, but not yet analysed the 
information. The number can still be 
incomplete. AppHcations might set notification 
for this event when part of the number analysis 
needs to be done in the application. 


P_EVENT_GCCS_ADDRESS_ANALYSED_EVENT 


4 


GCCS - Address information is analysed. 

The dialled number is a vaUd and complete 
number in the network. 


P_EVENT_GCCS_CALLED_PARTY_BUSY 


8 


GCCS - Called party is busy 


P_EVENT_GCCS_CALLED_PARTY_UNREACHABLE 


16 


GCCS - Called party is unreachable 

This can happen when the called party has a 
mobile phone that is switched off. 


P_EVENT_GCCS_NO_ANSWER_FROM_CALLED_PARTY 


32 


GCCS - No answer from called party 


P_EVENT_GCCS_ROUTE_SELECT_FAILURE 


64 


GCCS - Failure in routing the call 


P_EVENT_GCCS_ANSWER_FROM_CALL_PARTY 


128 


GCCS - Party answered call. 



8.3.2.2 TpCallEventCriteria 

Defines the Sequence of Data Elements that specify the criteria for an event notification. 





Sequence Element Nam^^^"i' Sequence Element Type 1 




^escripti^^ 




DestinationAddress 


TpAddressRange 


Defines the destination address or 

address range for which the 

notification is requested 
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OriginationAddress 


TpAddressRange 


Defines the origination address or 

address range for which the 

notification is requested 


Cal IE vent Name 


TpCal IE vent Name 


Name of the event (s) 


CallNotificationType 


TpCallNotificationType 


Indicates whether it is related to 

the originating or the terminating 

user in the call. 


MonitorMode 


TpCallMonitorMode 


Defines the mode that the call is 

in following the notification. 

Monitor mode 

P_CALL_MONITOR_MODE_DO_NOT_MONITOR 

is not a legal value here. 



8.3.2.3 



TpCallEventCriteriaResult 



Defines a sequence of data elements that specify a requested call event notification criteria with the associated 
assignmentlD. 



1 Sequence Element 
L Name 


Sequence Element 
Type 


Sequence Element Description 


EventCriteria 


TpCallEvent Criteria 


The event criteria that were specified by 
the application. 


AssignmentlD 


Tplnt32 


The associated assignementID . This can be 
used to disable the notification. 



8.3.2.4 TpCallEventCriteriaResultSet 

Defines a set of TpCallEventCriteriaResult. 



8.3.2.5 



TpCallNotificationType 



Defines the type of notification. Indicates whether it is related to the originating or the terminating user in the call. 



I^K Name 


Value 


Description 


P_ORIGINATING 


1 


Indicates that the notification is related to the 
originating user in the call. 


P_TERMINATING 


2 


Indicates that the notification is related to the 
terminating user in the call. 



8.3.2.6 TpCallEventlnfo 

Defines the Sequence of Data Elements that specify the information returned to the application in a New Call event 
notification. 



\ 


Sequence Element Name , 




1 


Sequence Element Type , 




, 












DestinationAddress 


TpAddress 


OriginatingAddress 


TpAddress 


OriginalDestinationAddress 


TpAddress 


Redirect ingAddress 


TpAddress 


CallAppInfo 


TpCallAppInfoSet 


CallEventName 


TpCallEventName 


CallNotificationType 


TpCallNotificationType 
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8.3.3 Generic Call Control Type definitions 

8.3.3.1 TpCallAlertingMechanism 

This data type is identical to a Tplnt32, and defines the mechanism that will be used to alert a called party. The values 
of this data type are operator specific. 

8.3.3.2 TpCallApplnfo 

Defines the Tagged Choice of Data Elements that specify application-related call information. 











TpCallAppInfoType 







Tag Element VafflW 




1 


Choice Element Ty]IF 


1 


1 


^Hioice Element Na^^l 




P_CALL_APP_ALERTING_MECHANISM 


TpCallAlertingMechanism 


CallAppAlertingMechanism 


P_CALL_APP_NETWORK_ACCESS_TYPE 


TpCallNetworkAccessType 


CallAppNetworkAccessType 


P_CALL_APP_TELE_SERVICE 


TpCallTeleService 


CallAppTeleService 


P_CALL_APP_BEARER_SERVICE 


TpCallBearer Service 


CallAppBearer Service 


P_CALL_APP_P ART Y_CATE GORY 


TpCallPartyCategory 


CallAppPartyCategory 


P_CALL_APP_PRESENTATION_ADDRESS 


TpAddress 


CallAppP resent at ionAddress 


P_CALL_APP_GENERIC_INFO 


TpString 


CallAppGenericInfo 


P_CALL_APP_ADDITIONAL_ADDRESS 


TpAddress 


CallAppAdditionalAddress 



CallAppPresentationAddress contains presentation address. 
CallAppGenericInfo contains operator specific information. 
CallAppAdditionalAddress contains additional address. 

8.3.3.3 TpCallAppInfoType 

Defines the type of application related call information. 



ima 


^^ 




Description 




P_CALL_APP_UNDEFINED 





Undefined 


P_CALL_APP_ALERTING_MECHANISM 


1 


The alerting mechanism or pattern to use 


P_CALL_APP_NETWORK_ACCESS_TYPE 


2 


The network access type (e.g. ISDN) 


P_CALL_APP_TELE_SERVICE 


4 


Indicates the tele-service (e.g. speech) and 
related info such as clearing programme 


P_CALL_APP_BEARER_SERVICE 


5 


Indicates the bearer service (e.g. 64kb/s 
unrestricted data). 


P_CALL_APP_P ART Y_CATE GORY 


6 


The category of the caUing or called party 


P_CALL_APP_PRESENTATION_ADDRESS 


7 


The address to be presented to other call 
parties 


P_CALL_APP_GENERIC_INFO 


8 


Carries unspecified application-Service 
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Capability Feature information 


P_CALL_APP_ADDITIONAL_ADDRESS 


9 


Indicates an additional address 



8.3.3.4 TpCallApplnfoSet 

Defines a Numbered Set of Data Elements of TpCallAppInfo. 

8.3.3.5 TpCallBearerService 

This data type defines the type of call application-related specific information (Q.931: Information Transfer Capability, 
and 3G TS 22.002) 











P_CALL_BEARER_SERVICE_UNKNOWN 





Bearer capability information unknown at this 
time 


P_CALL_BEARER_SERVICE_SPEECH 


1 


Speech 


P_CALL_BEARER_SERVICE_DIGITALUNREST 
RICTED 


2 


Unrestricted digital information 


P_CALL_BEARER_SERVICE_ 
DIGITALRESTRICTED 


3 


Restricted digital information 


P_CALL_BEARER_SERVICE_AUDIO 


4 


3 . 1 kHz audio 


P CALL BEARER SERVICE 
DIGITALUNRESTRICTEDTONES 


5 


Unrestricted digital information with 
tones /announcements 


P_CALL_BEARER_SERVICE_VIDEO 


6 


Video 



8.3.3.6 TpCallChargePlan 

Defines the Sequence of Data Elements that specify the charge plan for the call. 



Sequence Element Name 


1 




uence Element T] 




i 


Description 


1 


Char geOrder Type 


TpCallChargeOrder 


Charge order 


Currency 


TpString 


Currency unit according to ISO- 
4217:1995 


Additionallnfo 


TpString 


Descriptive string which is sent 

to the billing system without 

prior evaluation. Could be 

included in the ticket. 



Valid Currencies are: 



ADP, 


AED, 


AFA, 


ALL, 


AMD, 


ANG, 


AON, 


AOR, 


ARS, 


ATS, 


AUD, 


AWG, 


AZM, 


BAM, 


BBD, 


BDT, 


BEF, 


BGL, 


BGN, 


BHD, 


BIF, 


BMD, 


BND, 


BOB, 


BOV, 


BRL, 


BSD, 


BTN, 


BWP, 


BYB, 


BZD, 


CAD, 


CDF, 


CHE, 


CLE, 


CLP, 


CNY, 


COP, 


CRC, 


CUP, 


CVE, 


CYP, 


CZK, 


DEM, 


DJF, 


DKK, 


DOP, 


DZD, 


ECS, 


ECV, 


EEK, 


EGP, 


ERN, 


ESP, 


ETB, 


EUR, 


FIM, 


FJD, 


FKP, 


FRF, 


GBP, 


GEL, 


GHC, 


GIP, 


GMD, 


GNE, 


GRD, 


GTQ, 


GWP, 


GYD, 


HKD, 


HNL, 


HRK, 


HTG, 


HUE, 


IDR, 


lEP, 


ILS, 


INR, 


IQD, 


IRR, 


ISK, 


ITL, 


JMD, 


JOD, 


JPY, 


KES, 


KGS, 


KHR, 


KMF, 


KPW, 


KRW, 


KWD, 


KYD, 


KZT, 


LAK, 


LBP, 


LKR, 


LRD, 


LSL, 


LTL, 


LUF, 


LVL, 


LYD, 


MAD, 


MDL, 


MGF, 


MKD, 


MMK, 


MNT, 


MOP, 


MRO, 


MTL, 


MUR, 


MVR, 


MWK, 


MXN, 


MXV, 


MYR, 


MZM, 


NAD, 


NGN, 


NIO, 


NLG, 


NOK, 


NPR, 


NZD, 


OMR, 


PAB, 


PEN, 


PGK, 


PHP, 


PKR, 


PLN, 


PTE, 


PYG, 


QAR, 


ROL, 


RUB, 


RUR, 
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RWF, SAR, SBD, SCR, SDD, SEK, SGD, SHP, SIT, SKK, SLL, SOS, SRG, STD, 

SVC, SYP, SZL, THB, TJR, TMM, TND, TOP, TPE, TRL, TTD, TWD, TZS, UAH, 

UGX, USD, USN, USS, UYU, UZS, VEB, VND, VUV, WST, XAF, XAG, XAU, XBA, 

XBB, XBC, XBD, XCD, XDR, XFO, XFU, XOF, XPD, XPF, XPT, XTS, XXX, YER, 
YUM, ZAL, ZAR, ZMK, ZRN, ZWD . 

XXX is used for transactions where no currency is involved. 

8.3.3.7 TpCallChargeOrder 

Defines the Tagged Choice of Data Elements that specify the charge plan for the call. 





1 


Tag Element Type 


1 












TpCallChargeOrderCategory 





^^^^HTfia Flpmpnt Valiip ^^^H 


L Choice Element Tvoe M 


^^^K rhmVp Flpmpnt Namp ^^^^1 


L 






P_CALL_CHARGE_PER_TIME 


TpChargePerTime 


ChargePerTime 


P_CALL_CHARGE_NETWORK 


TpString 


NetworkCharge 



8.3.3.8 TpCallChargeOrderCategory 



Name 


i 




^ Description ^^^" 


„^^^^^, 


P_CALL_CHARGE_PER_TIME 





Charge per time 


P_CALL_CHARGE_NETWORK 


1 


Operator specific charge plan specification, e.g. 
charging table name / charging table entry 



8.3.3.9 TpCallEndedReport 

Defines the Sequence of Data Elements that specify the reason for the call ending. 





Sequence Element Nam< 


! 




Sequence Element Type 






L 












CallLegSessionID 


TpSessionID 


The leg that initiated the 
release of the call. 

If the call release was not 

initiated by the leg, then this 

value is set to -1. 


Cause 


TpCallReleaseCause 


The cause of the call ending. 
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8.3.3.10 TpCallError 

Defines the Sequence of Data Elements that specify the additional information relating to an undefined call error. 















1 


>equence j^^iemeni i>ame 






:^equeiice i^iemenr i yp 




ErrorTime 


TpDateAndTime 


ErrorType 


TpCallErrorType 


AdditionalErrorlnfo 


TpCallAdditionalErrorlnfo 



8.3.3.1 1 TpCallAdditionalErrorlnfo 

Defines the Tagged Choice of Data Elements that specify additional call error and call error specific information. This 
is also used to specify call leg errors and call information errors. 







Tag Element Ty Ji^ 








TpCallErrorType 











■n^luyh^a^|mi^ 


i«mTi^»gngn«iraL 


ITO^JWwnwajcmyr^ 


P_CALL_ERROR_UNDEF I NED 


NULL 


Undefined 


P_CALL_ERROR_INVAL ID_ADDRE S S 


TpAddressError 


CallErrorlnvalidAddress 


P_CALL_ERROR_INVALID_STATE 


NULL 


Undefined 



8.3.3.12 TpCallErrorType 

Defines a specific call error. 



mm 


^^^^T 




Description 










P_CALL_ERROR_UNDEF INED 





Undefined; the method failed or 

was refused, but no specific 

reason can be given. 


P_CALL_ERROR_INVALID_ADDRESS 


1 


The operation failed because an 
invalid address was given 


P_CALL_ERROR_INVALID_STATE 


2 


The call was not in a valid 

state for the requested 

operation 
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8.3.3.13 TpCallFault 

Defines the cause of the call fault detected. 



j^RTn^n 


AjFir™i 










luescripnoni 




P_CALL_FAULT_UNDEF INED 





Undefined 


P_T IMEOUT_ON_RELEASE 


1 


This fault occurs when the final report has 

been sent to the application, but the application 

did not explicitly release or deassign the call 

object, within a specified time. 

The timer value is operator specific. 


P_TIMEOUT_ON_INTERRUPT 


2 


This fault occurs when the application did not 

instruct the gateway how to handle the call 

within a specified time, after the gateway 

reported an event that was requested by the 

application in interrupt mode. 

The timer value is operator specific. 



8.3.3.14 TpCall Identifier 

Defines the Sequence of Data Elements that unambiguously specify the Generic Call object 



Seauence Element Name Seauence Element TvDe J^^^^l Seauence Element DescriDtion ^^^H 


■ 






CallReference 


IpCallRef 


This element specifies the interface 
reference for the call object. 


CallSessionID 


TpSessionID 


This element specifies the call session ID 
of the call. 



8.3.3.15 TpCallldentifierRef 

Defines a Reference to type TpCallldentifier. 

8.3.3.16 TpCalllnfoReport 

Defines the Sequence of Data Elements that specify the call information requested. Information that was not requested 
is invalid. 



1 


Sequence Element Nam 


r 


1 


Sequence Element Type 




• 


)escription 






















CalllnfoType 


TpCalllnfoType 


The type of call report. 


Call InitiationSt art Time 


TpDateAndTime 


The time and date when the call, 
or follow-on call, was started. 


CallConnectedToResourceTime 


TpDateAndTime 


The date and time when the call 

was connected to the resource. 

This data element is only valid 

where information on user 

interaction is reported. 


CallConnectedToDestinationTime 


TpDateAndTime 


The date and time when the call 

was connected to the destination 

(i.e. when the destination 

answered the call) . If the 

destination did not answer the 

time is set to an empty string. 

This data element is invalid 

where information on user 

interaction is reported with an 

intermediate report . 


CallEndTime 


TpDateAndTime 


The date and time when the call, 
follow-on call or user- 
interaction was terminated. 


Cause 


TpCallReleaseCause 


The cause of call termination. 
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8.3.3.17 TpCalllnfoType 

Defines the type of call information requested and reported. The values may be combined by a logical 'OR' function. 



wmjT^m 


^gn^i 










uescripnon 




P_CALL_INFO_UNDEFINED 


OOh 


Undefined 


P_CALL_INFO_TIMES 


Olh 


Relevant call times 


P_CALL_INFO_RELEASE_CAUSE 


02h 


Call release cause 


P_CALL_INFO_INTERMEDIATE 


04h 


Send only intermediate reports. When this is 
not specified the information report will only 

be sent when the call has ended. When 

intermediate reports are requested a report will 

be generated between follow-on calls, i.e. 

when a party leaves the call. 



8.3.3.18 TpCallMonitorMode 

Defines the mode that the call will monitor for events, or the mode that the call is in following a detected event. 



^^ ^^^ 




Description 




P_CALL_MONI TOR_MODE_INTERRUP T 





The call event is intercepted by the call 

control SCF and call processing is 

interrupted. The application is notified of 

the event and call processing resumes 

following an appropriate API call or network 

event (such as a call release) 


P_CALL_MONITOR_MODE_NOTIFY 


1 


The call event is detected by the call control 

SCF but not intercepted. The application is 

notified of the event and call processing 

continues 


P_CALL_MONITOR_MODE_DO_NOT_MONITOR 


2 


Do not monitor for the event 



8.3.3.19 TpCallNetworkAccessType 

This data defines the bearer capabiHties associated with the call. (3G TS 24.002) This information is network operator 
specific and may not always be available because there is no standard protocol to retrieve the information. 



Name Value 






Description 


P_CALL_NETWORK_ACCESS_TYPE_UNKNOWN 





Network type information 
unknown at this time 


P_CALL_NETWORK_ACCESS_TYPE_POT 


1 


POTS 


P_CALL_NETWORK_ACCESS_TYPE_ISDN 


2 


ISDN 


P_CALL_NETWORK_ACCESS_TYPE_DIALUP INTERNET 


3 


Dial-up Internet 


P_CALL_NETWORK_ACCESS_TYPE_XDSL 


4 


xDSL 


P_CALL_NETWORK_ACCESS_TYPE_WIRELESS 


5 


Wireless 



8.3.3.20 TpCallOverloadType 

Defines the type of call overload that has been detected (and possibly acted upon) by the network. 



^^^^^^^j^ 


TWfflm 




JJgscription 






^^^^^H 




P_CALL_OVERLOAD_TYPE_UNDEFINED 





Infinite interval 
(do not admit any calls) 
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P_CALL_OVERLOAD_TYPE_NEW_CALLS 


1 


New calls to the application 

are causing overload (i.e. 

inbound overload) 


P_CALL_OVERLOAD_TYPE_ROUTED_CALLS 


2 


Calls being routed to 

destination or origination 

addresses by the application 

are causing overload (i.e. 

outbound overload) 



8.3.3.21 TpCallServiceCode 

Defines the Sequence of Data Elements that specify the service code and type of service code received during a call. 
The service code type defines how the value string should be interpreted. 



j^fmmjmwismm^^jmm 


^^gairaii^urangn»|r 


CallServiceCodeType 


TpCallServiceCodeType 


ServiceCodeValue 


TpString 



8.3.3.22 TpCallServiceCodeType 

Defines the different types of service codes that can be received during the call. 



II 


^^^Tffiif 


HTSfSBRTRfffl 


P_CALL_SERVICE_CODE_UNDEFINED 





The type of service code is unknown. The 
corresponding string is operator specific. 


P_CALL_SERVICE_CODE_DIGITS 


1 


The user entered a digit sequence during the 
call. The corresponding string is an ascii 
representation of the received digits. 


P_CALL_SERVICE_CODE_F AGILITY 


2 


A facility information element is received. 
The corresponding string contains the facility 
information element as defined in ITU Q.932 


P_CALL_SERVICE_C0DE_U2U 


3 


A user-to-user message was received. The 
associated string contains the content of the 
user-to-user information element. 


P_CALL_SERVICE_CODE_HOOKFLASH 


4 


The user performed a hookflash, optionally 
followed by some digits. The corresponding 
string is an ascii representation of the 
entered digits. 


P_CALL_SERVICE_CODE_RECALL 


5 


The user pressed the register recall button, 
optionally followed by some digits. The 
corresponding string is an ascii 
representation of the entered digits. 



8.3.3.23 TpCallPartyCategory 

This data type defines the category of a calling party. (Q.763: Calling Party Category / Called Party Category) 



WSM 


~^^H" 




1 


Description 












P_CALL_PARTY_CATEGORY_UNKNOWN 





calling party's category unknown at this time 


P_CALL_PARTY_CATEGORY_OPERATOR_F 


1 


operator, 


language French 




P_CALL_PARTY_CATEGORY_OPERATOR_E 


2 


operator, 


language English 




P_CALL_PARTY_CATEGORY_OPERATOR_G 


3 


operator, 


language German 




P_CALL_PARTY_CATEGORY_OPERATOR_R 


4 


operator. 


language Russian 




P_CALL_PARTY_CATEGORY_OPERATOR_S 


5 


operator. 


language Spanish 
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P_CALL_PARTY_CATEGORY_ORDINARY_SUB 


6 


ordinary calling subscriber 


P_CALL_PARTY_CATEGORY_PRIORITY_SUB 


7 


calling subscriber with priority 


P_CALL_PARTY_CATEGORY_DATA_CALL 


8 


data call (voice band data) 


P_CALL_PARTY_CATEGORY_TEST_CALL 


9 


test call 


P_CALL_P ART Y_CATEGORY_PAYP HONE 


10 


payphone 



8.3.3.24 TpCallReleaseCause 

Defines the Sequence of Data Elements that specify the cause of the release of a call. 



Sequence Element Name 



■ffH^V**- 



Value 



Sequence Element Type 



Tplnt32 



Location 



Tplnt32 



Note: the Value and Location are specified as in ITU-T recommendation Q.850. 

8.3.3.25 TpCallReport 

Defines the Sequence of Data Elements that specify the call report and call leg report specific information. 



1 


Sequence Elemen 


[i?m??^r 


- 


jquence Element Typ 
1 


1 


MonitorMode 


TpCallMonitorMode 


CallEventTime 


TpDateAndTime 


CallReportType 


TpCallReport Type 


AdditionalReportlnfo 


TpCallAdditionalReportlnfo 



8.3.3.26 TpCallAdditionalReportlnfo 

Defines the Tagged Choice of Data Elements that specify additional call report information for certain types of reports. 





1 


Tag Element Ty^ 








TpCallReportType 











^igngn^gn 


jngagngnmra^^ 


^rrgagngTij^RTjigi 


P_CALL_REPORT_UNDEFINED 


NULL 


Undefined 


P_CALL_REPORT_PROGRESS 


NULL 


Undefined 


P_CALL_REPORT_ALERTING 


NULL 


Undefined 


P_CALL_REPORT_ANSWER 


NULL 


Undefined 


P_CALL_REPORT_REFUSED_BUSY 


TpCallReleaseCause 


RefusedBusy 


P_CALL_REPORT_NO_ANSWER 


NULL 


Undefined 


P_CALL_REPORT_DISCONNECT 


TpCallReleaseCause 


Cal ID is connect 


P_CALL_REPORT_REDIRECTED 


TpAddress 


ForwardAddress 


P_CALL_REPORT_SERVICE_CODE 


TpCallServiceCode 


ServiceCode 


P_CALL_REP ORT_ROUT ING_FAI LURE 


TpCallReleaseCause 


Rout ingFai lure 
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8.3.3.27 TpCallReportRequest 

Defines the Sequence of Data Elements that specify the criteria relating to call report requests. 















1 


>equence j^^iemeni i>ame 






:!>equence i^iemenr i yp 




MonitorMode 


TpCallMonitorMode 


CallReportType 


TpCallReportType 


AdditionalReport criteria 


TpCallAdditionalReportCriteria 



8.3.3.28 TpCallAdditionalReportCriteria 

Defines the Tagged Choice of Data Elements that specify specific criteria. 







iTag Element Type ^ 














TpCallReportType 











P_CALL_REPORT_UNDEFINED 


NULL 


Undefined 


P_CALL_REPORT_PROGRESS 


NULL 


Undefined 


P_CALL_REPORT_ALERTING 


NULL 


Undefined 


P_CALL_REPORT_ANSWER 


NULL 


Undefined 


P_CALL_REPORT_BUSY 


NULL 


Undefined 


P_CALL_REPORT_NO_ANSWER 


TpDuration 


NoAnswerDuration 


P_CALL_REPORT_DISCONNECT 


NULL 


Undefined 


P_CALL_REPORT_REDIRECTED 


NULL 


Undefined 


P_CALL_REPORT_SERVICE_CODE 


TpCallServiceCode 


ServiceCode 


P_CALL_REPORT_ROUTING_FAILURE 


NULL 


Undefined 



8.3.3.29 TpCallReportRequestSet 

Defines a Numbered Set of Data Elements of TpCallReportRequest. 

8.3.3.30 TpCallReportType 

Defines a specific call event report type. 



1 IfFSTRTW 


^^uiHi 




P_CALL_REPORT_UNDEFINED 





Undefined 


P_CALL_REPORT_PROGRESS 


1 


Call routing progress event: an 
indication from the network 

that progress has been made in 
routing the call to the 
requested called party. 


P_CALL_REPORT_ALERTING 


2 


Call is alerting at the called 
party. 


P_CALL_REPORT_ANSWER 


3 


Call answered at address 


P_CALL_REPORT_BUSY 


4 


Called address refused call due 
to busy 


P_CALL_REPORT_NO_ANSWER 


5 


No answer at called address 


P_CALL_REPORT_DISCONNECT 


6 


The called party has 
disconnected. 


P_CALL_REPORT_REDIRECTED 


7 


Call redirected to new address: 

an indication from the network 

that the call has been 
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redirected to a new address. 


P_CALL_REPORT_SERVICE_CODE 


8 


Mid-call service code received 


P_CALL_REP ORT_ROUT ING_F AI LURE 


9 


Call routing failed - re- 
routing is possible 
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8.3.3.31 TpCallServiceCode 

Defines the service code received during a call. For example, this may be a digit sequence, user-user information, recall, 
flash-hook or ISDN Facility Information Element. 

This data type is identical to a TpString. The coding of this data type is operator specific. However, the values defined 
in ISUP ITU Recommendation Q.763 are suggested for this data type. 

8.3.3.32 TpCallTeleService 

This data type defines the tele-service associated with the call. (Q.763: User Teleservice Information, Q.931: High 
Layer Compatitibility Information, and 3G TS 22.003) 



^^^^riS^k 






1 


P_CALL_TELE_SERVICE_UNKNOWN 





Teleservice information unknown at this 
time 


P_CALL_TELE_SERVICE_TELEPHONY 


1 


Telephony 


P_CALL_TELE_SERVICE_FAX_2_3 


2 


Facsimile Group 2/3 


P_CALL_TELE_SERVICE_FAX_4_I 


3 


Facsimile Group 4, Class I 


P_CALL_TELE_SERVICE_FAX_4_I I_I I I 


4 


Facsimile Group 4, Classes II and III 


P_CALL_TELE_SERVICE_VIDEOTEX_SYN 


5 


Syntax based Videotex 


P_CALL_TELE_SERVICE_VIDEOTEX_INT 


6 


International Videotex interworking via 
gateways or interworking units 


P_CALL_TELE_SERVICE_TELEX 


7 


Telex service 


P_CALL_TELE_SERVICE_MHS 


8 


Message Handling Systems 


P_CALL_TELE_SERVICE_OSI 


9 


OSI application 


P_CALL_TELE_SERVICE_FTAM 


10 


FTAM application 


P_CALL_TELE_SERVICE_VIDEO 


11 


Videotelephony 


P_CALL_TELE_SERVICE_VIDEO_CONF 


12 


Videoconferencing 


P_CALL_TELE_SERVICE_AUDIOGRAPH_CONF 


13 


Audiographic conferencing 


P_CALL_TELE_SERVICE_MULT IMED I A 


14 


Multimedia services 


P_CALL_TELE_SERVICE_CS_INI_H2 21 


15 


Capability set of initial channel of H.221 


P_CALL_TELE_SERVICE_CS_SUB_H2 21 


16 


Capability set of subsequent channel of 
H.221 


P_CALL_TELE_SERVICE_CS_INI_CALL 


17 


Capability set of initial channel 
associated with an active 3.1 kHz audio or 
speech call. 


P_CALL_TELE_SERVICE_DATATRAFFIC 


18 


Data traffic. 


P_CALL_TELE_SERVICE_EMERGENCY_CALLS 


19 


Emergency Calls 


P_CALL_TELE_SERVICE_SMS_MT_PP 


20 


Short message MT/PP 


P_CALL_TELE_SERVICE_SMS_MO_PP 


21 


Short message MO/PP 


P_CALL_TELE_SERVICE_CELL_BROADCAST 


22 


Cell Broadcast Service 


P_CALL_TELE_SERVICE_ALT_SPEECH_FAX_3 


23 


Alternate speech and facsimile group 3 


P_CALL_TELE_SERVICE_AUT0MATIC_FAX_3 


24 


Automatic Facsimile group 3 


P_CALL_TELE_SERVICE_VOICE_GROUP_CALL 


25 


Voice Group Call Service 


P_CALL_TELE_SERVICE_VOICE_BROADCAST 


26 


Voice Broadcast Service 
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8.3.3.33 TpCallSuperviseReport 

Defines the responses from the call control SCF for calls that are supervised. The values may be combined by a logical 
'OR' function. 









P_CALL_SUPERVI SE_T IMEOUT 


Olh 


The call supervision timer has 
expired 


P_CALL_SUPERVISE_CALL_ENDED 


02h 


The call has ended, either due 
to timer expiry or call party 
release. In case the called 
party disconnects but a follow- 
on call can still be made also 
this indication is used. 


P_CALL_SUPERVISE_TONE_APPLIED 


04h 


A warning tone has been 

applied This is only sent in 

combination with 

P_CALL_SUPERVISE_T IMEOUT . 


P_CALL_SUPERVISE_UI_FINISHED 


08h 


The user interaction has 
finished. 
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8.3.3.34 TpCallSuperviseTreatment 

Defines the treatment of the call by the call control SCF when the call supervision timer expires. The values may be 
combined by a logical 'OR' function. 



1 kkUJiI^ 


wm 


nraswTfflm 


P_CALL_SUPERVISE_RELEASE 


Olh 


Release the call when the call 
supervision timer expires 


P_CALL_SUPERVISE_RESPOND 


02h 


Notify the application when the 
call supervision timer expires 


P_CALL_SUPERVISE_APPLY_TONE 


04h 


Send a warning tone to the 
controlling party when the call 

supervision timer expires. If 

call release is requested, then 

the call will be released 

following the tone after an 

administered time period. 



8.4 



User Interaction Data Definitions 



The constants and types defined in the following sections are defined in the org.threegpp.osa.guis package. 

8.4.1 Interface definitions 

8.4.1.1 IpUl 

Defines the address of an lUI Interface. 

8.4.1.2 IpUIRef 

Defines a Reference to type lUI. 

8.4.1.3 IpUIRefRef 

Defines a Reference to type lUIRef . 

8.4.1.4 IpUIManager 

Defines the address of an lUIManager Interface. 

8.4.1.5 IpUIManagerRef 

Defines a Reference to type lUIManager. 

8.4.1.6 IpAppUl 

Defines the address of an lAppUI Interface. 

8.4.1.7 IpAppUIRef 

Defines a Reference to type lAppUI. 

8.4.1.8 IpAppUIRefRef 

Defines a Reference to type lAppUIRef . 
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8.4.1 .9 IpAppUIManager 

Defines the address of an lAppUIManager Interface. 

8.4.1.10 IpAppUIManagerRef 

Defines a Reference to type lAppUIManager. 

8.4.2 Type definitions 
8.4.2.1 TpUICallldentifier 

Defines the Sequence of Data Elements that unambiguously specify the UlCall object 
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Structure Element Nani^* 


^^tructure Elemen^f 
Type M 




^ Structure Element Descripti^^ 

1 


! 


1 










UICallRef 


IpUICallRef 


This element specifies the interface 
reference for the UlCall object. 


UserlnteractionSessionID 


TpSessionID 


This element specifies the user interaction 
session ID. 



8.4.2.2 TpUICallldentifierRef 

Defines a reference to type TpUICallldentifier. 

8.4.2.3 TpUICollectCriteria 

Defines the Sequence of Data Elements that specify the additional properties for the collection of information, such as 
the end character, first character timeout, inter-character timeout, and maximum interaction time. 



liiiiiiiijiiiiijijiji 


MillJIiyjIlijjIIIB 


MinLength 


Tplnt32 


MaxLength 


Tplnt32 


EndSequence 


TpString 


StartTimeout 


TpDuration 


Inter Char Timeout 


TpDuration 



The structure elements specify the following criteria: 

MinLength : Defines the minimum number of characters (e.g. digits) to collect. 



MaxLength : 
EndSequence : 

StartTimeout : 



InterCharTimeOut : 



Defines the maxmum number of characters (e.g. digits) to collect. 

Defines the character or characters which terminate an input of variable length, e.g. 
phonenumbers. 

specifies the value for the first character time-out timer. The timer is started when the 
announcement has been completed or has been interrupted. The user should enter the start 
of the response (e.g. first digit) before the timer expires. If the start of the response is not 
entered before the timer expires, the input is regarded to be erroneous. After receipt of the 
start of the response, which may be valid or invalid, the timer is stopped. 

specifies the value for the inter-character time-out timer.The timer is started when a 
response (e.g. digit) is received, and is reset and restarted when a subsequent response is 
received. The responses may be valid or invalid, the announcement has been completed or 
has been interrupted. 

Input is considered successful if the following applies: 
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If the EndSequence is not present (i.e. NULL): 

when the Inter Char TimeOut timer expires; or 

- when the number of valid digits received equals the MaxLengt h. 
If the EndSequence is present: 

when the Inter Char TimeOut timer expires; or 

- when the EndSequence is received; or 

when the number of valid digits received equals the MaxLengt h. 

In the case the number of valid characters received is less than the MinLength when the InterCharTimeOut timer 
expires or when the EndSequence is received, the input is considered erroneous. 

The collected characters (including the EndSequence) are sent to the client application when input hs been 
successful. 



8.4.2.4 TpUIError 

Defines the UI call error codes. 



^sm 


^^^31 




Description, 










P_UI_ERROR_UNDEFINED 





Undefined error 


P_UI_ERROR_ILLEGAL_ID 


1 


The information id specified is invalid 


P_UI_ERROR_ID_NOT_FOUND 


2 


A legal information id is not known to the the 
User Interaction SCF 


P_UI_ERROR_RESOURCE_UNAVAILABLE 


3 


The information resources used by the User 

Interaction SCF are unavailable, e.g. due to an 

overload situation. 


P_UI_ERROR_ILLEGAL_RANGE 


4 


The values for minimum and maximum 
collection length are out of range 


P_UI_ERROR_IMPROPER_CALLER_RESPONSE 


5 


Improper user response 


P_UI_ERROR_ABANDON 


6 


The specified leg is disconnected before the 
send information completed 


P_UI_ERROR_NO_OPERAT ION_ACT I VE 


7 


There is no active user interaction for the 

specified leg. Either the appHcation did not 

start any user interaction or the user interaction 

was already finished when the 

abort Act ion_Req ( ) was called. 


P_UI_ERROR_NO_SPACE_AVAILABLE 


8 


There is no more storage capacity to record the 

message when the recordMessage ( ) 

operation was called 



The call user interaction object will be automatically de-assigned if the error P_UI_ERROR_ ABANDON is reported, as 
a corresponding call or call leg object no longer exists. 

8.4.2.5 TpUIEventCriteria 

Defines the Sequence of Data Elements that specify the additional criteria for receiving a UI notification 





1 


HHil 


OriginatingAddress 


TpAddressRange 


Defines the originating address 

for which the notification is 

requested. 


DestinationAddress 


TpAddressRange 


Defines the destination address 

or address range for which the 

notification is requested. 


ServiceCode 


TpString 


Defines a 2 digit code indicating 

the UI to be triggered. The value 

is operator specific. 
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8.4.2.6 TpUIEventlnfo 

Defines the Sequence of Data Elements that specify a UI notification 



E' 












:^rruciure i^.iemeni i>ame 






structure j^^iemeni i ype i 




OriginatingAddress 


TpAddress 


Defines the originating address. 


DestinationAddress 


TpAddress 


Defines the destination address. 


ServiceCode 


TpString 


Defines a 2 digit code indicating 

the UI to be triggered. The value 

is operator specific. 


DataType Indication 


TpUIEventlnfoDataType 


Identifies the type of contents 
in the dataString. 


DataString 


TpString 


Freely defined data string with a 

limited length e.g. 160 bytes 
according to the network policy. 



8.4.2.7 TpUIEventlnfoDataType 

Defines the type of the dataString parameter in the method userlnteractionEventNotify. 



iHii 


IB 


iiiliiii 


P_UI_EVENT_DATA_TYPE_UNDEFINED 





Undefined (e.g. binary data) 


P_UI_EVENT_DATA_TYPE_UNSPECIFIED 


1 


Unspecified data 


P_UI_EVENT_DATA_TYPE_TEXT 


2 


Text 


P_UI_EVENT_DATA_TYPE_USSD_DATA 


3 


USSD data starting with coding scheme 



8.4.2.8 TpUIFault 

Defines the cause of the UI fault detected. 










^ Description ^ 


«_ 


P_UI_FAULT_UNDEFINED 





Undefined 


P_U I_CALL_DE AS S I GNED 


1 


The related Call object has been deassigned. 

No further interaction is possible. Already 

requested announcements will continue but no 

requested reports will be send to the 

appHcation. 



8.4.2.9 TpUlldentifier 

Defines the Sequence of Data Elements that unambiguously specify the UI object 



1 1 






:!>irucrure j^^iemeni i>ame :^iruciure j 

TVD 


■ 


■■■■■■i 


r 






UIRef 


IpUIRef 


This element specifies the interface 
reference for the UI object. 


UserlnteractionSessionID 


TpSessionID 


This element specifies the user interaction 
session ID. 



8.4.2.10 TpUlldentifierRef 

Defines a reference to type TpUlldentifier. 
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8.4.2.11 TpUllnfo 

Defines the Tagged Choice of Data Elements that specify the information to send to the user. 



'as Element Tv 



TpUIInfoType 



'^^^^^tag Element Val^P 


1 1 


I^^Wioice Element Type 






'hoice Element Name 


1 


P_UI_INFO_ID 


Tplnt32 


Infold 


P_UI_INFO_DATA 


TpString 


InfoData 


P_UI_INFO_ADDRESS 


TpURL 


InfoAddress 



The choice elements represents the following: 

InfoID: 



InfoData : 



InfoAddress : 



defines the ID of the user information script or stream to send to an end-user. The values of 
this data type are operator specific. 

defines the data to be sent to an end-user's terminal. The data is free-format and the 
encoding is depending on the resources being used.. 

defines the URL of the text or stream to be sent to an end-user's terminal. 



8.4.2.12 TpUIInfoType 

Defines the type of the information to be sent to the user. 



!■ 


^^ 




Description 




P_UI_INFO_ID 


1 


The information to be send to an end-user 
consists of an ID 


P_UI_INFO_DATA 


2 


The information to be send to an end-user 
consists of a data string 


P_UI_INFO_ADDRESS 


3 


The information to be send to an end-user 
consists of a URL. 



8.4.2.13 TpUIMessageCriteria 

Defines the Sequence of Data Elements that specify the additional properties for the recording of a message 





Structure Element Name 


1 




Structure Element Typ 


\ 


EndSequence 


TpString 


MaxMes sage Time 


TpDuration 


MaxMessageSize 


Tplnt32 



The structure elements specify the following criteria: 

EndSequence : 



MaxMessageTime : 
MaxMessageSize : 



Defines the character or characters which terminate an input of variable length, e.g. 
phonenumbers. 

specifies the maximum duration in seconds of the message that is to be recorded. 

If this parameter is non-zero, it specifies the maximum size in bytes of the message that is 
to be recorded. 



8.4.2.14 TpUIReport 

Defines the UI call reports if a response was requested. 
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BBSH 






Description 




P_UI_REPORT_UNDEFINED 





Undefined report 


P_UI_REPORT_ANNOUNCEMENT_ENDED 


1 


Confirmation that the announcement has ended 


P_UI_REPORT_LEGAL_INPUT 


2 


Information collected., meeting the specified 
criteria. 


P_UI_REPORT_NO_INPUT 


3 


No information collected. The user 

immediately entered the delimiter character. 

No valid information has been returned 


P_UI_REPORT_TIMEOUT 


4 


No information collected. The user did not 

input any response before the input timeout 

expired 


P_UI_REPORT_MESSAGE_STORED 


5 


A message has been stored successfully 


P_UI_REP ORT_ME S S AGE_NOT_S TORED 


6 


The message has not been stored successfully 



ETSI 



3G TS 29.198 version 3.0.0 Release 1999 



102 



ETSI TS 129 198 V3.0.0 (2000-06) 



8.4.2.15 TpUIResponseRequest 

Defines the situations for which a response is expected following the user interaction. 



^mjT^ 


muj^i 










iLiescripnoni 










P_UI_RESPONSE_REQUIRED 


1 


The User Interaction Call must send a response 
when the request has completed. 


P_U I_L AS T_ANNOUNCEMENT_IN_A_ROW 


2 


This is the final announcement within a 

sequence. It might, however, be that additional 

announcements will be requested at a later 

moment. The Call User Interaction Call SCF 

may release any used resources in the network. 

The UI object will not be released. 


P_UI_FINAL_REQUEST 


4 


This is the final request. The UI object will be 

released after the information has been 

presented to the user. 



This parameter represent a bitmask, i.e. the values can be added to derived the final meaning. 

8.4.2.16 TpUIVariablelnfo 

Defines the Tagged Choice of Data Elements that specify the variable parts in the information to send to the user. 







Tag Element Type 

1 








TpUIVariablePartType 





i ■ 
1 


Element Vali 


p 


1 


mice Element T> 


W 




I!hoice Element ]> 






















P_UI_VARIABLE_PART_INT 


Tplnt32 


VariablePart Integer 


P_UI_VARIABLE_PART_ADDRESS 


TpString 


VariableP art Address 


P_UI_VARIABLE_PART_TIME 


TpTime 


VariablePart Time 


P_UI_VARIABLE_PART_DATE 


TpDate 


VariablePartDate 


P_UI_VARIABLE_PART_PRICE 


TpPrice 


VariablePartPrice 



8.4.2.17 TpUIVariablelnfoSet 

Defines a Numbered Set of Data Elements of TpUIVariablelnfo. 

8.4.2.18 TpUIVariablePartType 

Defines the type of the variable parts in the information to send to the user. 



^^^^^^iH 


HHUMi 


' Description 




P_UI_VARIABLE_PART_INT 





Variable part is of type integer 


P_UI_VARIABLE_PART_ADDRESS 


1 


Variable part is of type address 


P_UI_VARIALBE_PART_TIME 


2 


Variable part is of type time 


P_UI_VARIABLE_PART_DATE 


3 


Variable part is of type date 


P_UI_VARIABLE_PART_PRICE 


4 


Variable part is of type price 



8.5 



Data Session Control Data Definitions 



The constants and types defined in the following sections are defined in the org.threegpp.osa.dscs package. 
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8.5.1 Interface definitions 
85. 1 . 1 IpAppDataSession 

Defines the address of an IpAppDataSession Interface. 

8.5.1 .2 IpAppDataSessionRef 

Defines a Reference to type IpAppDataSession 

8.5.1 .3 IpAppDataSessionRefRef 

Defines a Reference to type IpAppDataSessionRef. 

8.5.1 .4 IpAppDataSessionControlManager 

Defines the address of an IpAppDataSessionControlManager Interface. 

8.5.1 .5 IpAppDataSessionControlManagerRef 

Defines a Reference to type IpAppDataSessionControlManager. 

8.5.1.6 IpDataSession 

Defines the address of an IpDataSession Interface. 

8.5.1 .7 IpDataSessionRef 

Defines a Reference to type IpDataSession. 

8.5.1 .8 IpDataSessionRefRef 

Defines a Reference to type IpDataSessionRef. 

8.5.1 .9 IpDataSessionControlManager 

Defines the address of an IpDataSessionManager Interface. 

8.5.1.10 IpDataSessionManagerRef 

Defines a Reference to type IpDataSessionControlManager. 

8.5.2 Event Notification data definitions 
8.5.2.1 TpDataSessionEventName 

Defines the names of events being notified with a new call request. The following events are supported. The values may 
be combined by a logical 'OR' function when requesting the notifications. Additional events that can be requested / 
received during the call process are found in the TpDataSessionReportType data-type. 



1 ^^^^^^^^^^^^^^^^^^ I^RifuV 


"^fflff 




LQEScription 






^■^^1 




P_EVENT_NAME_UNDEF INED 





Undefined 


P_EVENT_DSCS_SETUP 


1 


The data session is going to be setup. 


P_EVENT_DSCS_ESTABLISHED 


2 


The data session is estabUshed by the network. 
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8.5.2.2 



TpDataSessionMonitorMode 



Defines the mode that the call will monitor for events, or the mode that the call is in following a detected event. 



II 


V/IWIP 




DescriDtion 










P_DATA_SESSION_MONITOR_MODE_INTERRUPT 





The data session event is intercepted by the 

data session control service and data session 

establishment is interrupted. The application is 

notified of the event and data session 

establishement resumes following an 

appropriate API call or network event (such as 

a data session release) 


P_DATA_SESSION_MONITOR_MODE_NOTIFY 


1 


The data session event is detected by the data 
session control service but not intercepted. The 
appHcation is notified of the event and data 
session establishment continues 


P_DATA_SESSION_MONITOR_MODE_DO_NOT_MONITOR 


2 


Do not monitor for the event 



8.5.2.3 



TpDataSessionEventCriteria 



Defines the Sequence of Data Elements that specify the criteria for a event notification. 

Of the addresses only the Plan and the AddrString are used for the purpose of matching the notifications against the 
criteria. 



r 



Sequence Element Name 



Sequence Element Type 



description 



DestinationAddress 



TpAddressRange 



Defines the destination address 

or address range for which the 

notification is requested. 



OriginatingAddress 



TpAddressRange 



Defines the origination address 

or a address range for which the 

notification is requested. 



DataSessionEventName 



TpDataSessionEventName 



Name of the event (s) 



MonitorMode 



TpDataSessionMonitorMode 



Defines the mode that the Data 
Session is in following the 
notification . 
Monitor mode 

P_DATA_SESSION_MONITOR_MODE_DO_NO 
T_MONITOR is not a legal value 
here . 



8.5.2.4 



TpDataSessionEventlnfo 



Defines the Sequence of Data Elements that specify the information returned to the application inaData Session 
event notification. 















1 


sequence r.iemeni i^ame i 




1 


sequence niemeni i yp 




DestinationAddress 


TpAddress 


OriginatingAddress 


TpAddress 


DataSessionEventName 


TpDataSessionEventName 


MonitorMode 


TpDataSessionMonitorMode 



8.5.2.5 TpDataSessionChargePlan 

Defines the Sequence of Data Elements that specify the charge plan for the call. 



Sequence Element Na 



Sequence Element Type 



Description 
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Char geOrder Type 


TpDataSessionChargeOrder 


Charge order 


Currency 


TpString 


Currency unit according to ISO- 
4217:1995 


Additional Info 


TpString 


Descriptive string which is 

sent to the billing system 

without prior evaluation. Could 

be included in the ticket. 



Valid Currencies are: 



ADP, 


AED, 


AFA 


. ALL 


. AMD, 


ANG, 


AON, 


AOR, 


ARS, 


ATS, 


AUD, 


AWG, 


AZM, 


BBD, 


BDT, 


BEE 


. BGL 


. BGN, 


BHD, 


BIE, 


BMD, 


BND, 


BOB, 


BOV, 


BRL, 


BSD, 


BWP, 


BYB, 


BZD 


. CAD 


. CDE, 


CHE, 


CLE, 


CLP, 


CNY, 


COP, 


CRC, 


CUP, 


CVE, 


CZK, 


DEM, 


DUE 


. DKK 


. DOP, 


DZD, 


ECS, 


ECV, 


EEK, 


EGP, 


ERN, 


ESP, 


ETB, 


FIM, 


FJD, 


EKP 


. ERE 


. GBP, 


GEL, 


GHC, 


GIP, 


GMD, 


GNE, 


GRD, 


GTQ, 


GWP, 


HKD, 


HNL, 


HRK 


. HTG 


. HUE, 


IDR, 


lEP, 


ILS, 


INR, 


IQD, 


IRR, 


ISK, 


ITL, 


JOD, 


JPY, 


KES 


. KGS 


. KHR, 


KME, 


KPW, 


KRW, 


KWD, 


KYD, 


KZT, 


LAK, 


LBP, 


LRD, 


LSL, 


LTL 


. LUE 


. LVL, 


LYD, 


MAD, 


MDL, 


MGE, 


MKD, 


MMK, 


MNT, 


MOP, 


MTL, 


MUR, 


MVR 


. MWK 


. MXN, 


MXV, 


MYR, 


MZM, 


NAD, 


NGN, 


NIO, 


NLG, 


NOK, 


NZD, 


OMR, 


PAB 


. PEN 


. PGK, 


PHP, 


PKR, 


PLN, 


PTE, 


PYG, 


QAR, 


ROL, 


RUB, 


RWF, 


SAR, 


SBD 


. SCR 


. SDD, 


SEK, 


SGD, 


SHP, 


SIT, 


SKK, 


SLL, 


SOS, 


SRG, 


SVC, 


SYP, 


SZL 


. THB 


. TJR, 


TMM, 


TND, 


TOP, 


TPE, 


TRL, 


TTD, 


TWD, 


TZS, 


UGX, 


USD, 


USN 


. USS 


. UYU, 


UZS, 


VEB, 


VND, 


VUV, 


WST, 


XAE, 


XAG, 


XAU, 


XBB, 


XBC, 


XBD 


. XCD 


. XDR, 


XEO, 


XEU, 


XOE, 


XPD, 


XPE, 


XPT, 


XTS, 


XXX, 


YUM, 


ZAL, 


ZAR 


, ZMK 


, ZRN, 


ZWD. 

















BAM, 
BTN, 
CYP, 
EUR, 
GYD, 
JMD, 
LKR, 
MRO, 
NPR, 
RUR, 
STD, 
UAH, 
XBA, 
YER, 



XXX is used for transactions where no currency is involved. 

8.5.2.6 TpDataSessionChargeOrder 

Defines the Tagged Choice of Data Elements that specify the charge plan for the call. 



E 



Tag Element Type 



■Xiay^at^v.^Bgrt^jir^ -ite-j 



TpDataSessionChargeOrderCategory 



t 



Tag Element Value 



Choice Element Type 



^.hoice Element Nam- 



P_DATA_SESSION_CHARGE_PER_VOLUME 



TpChargePerVolume 



Charge? erVolume 



P_D AT A_S E S S I ON_CHARGE_NE T WORK 



TpString 



NetworkCharge 



8.5.2.7 



TpDataSessionChargeOrderCategory 









P_DATA_SESSION_CHARGE_PER_VOLUME 





Charge per volume 


P_D AT A_S E S S I ON_CHARGE_NE T WORK 


1 


Operator specific charge plan specification, 

e.g. charging table name / charging table 

entry 
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8.5.2.8 



TpChargePerVolume 



Defines the Sequence of Data Elements that specify the time based charging information. The volume is the sum of 
uplink and downlink transfer data volumes. 





Sequence Element Nam 


r 




Sequence Element Type 


r 




Description 


r 


I 


















InitialCharge 


Tplnt32 


Initial charge amount (in currency 
units * 0.0001) 


Cur rent Char gePerKilobyte 


Tplnt32 


Current tariff (in currency units 
^ 0.0001) 


Next Char gePerKilobyte 


Tplnt32 


Next tariff (in currency units * 
0.0001) after tariff switch. 

Only used in setAdviceOf Charge ( ) 



8.5.2.9 TpDataSessionldentifier 

Defines the Sequence of Data Elements that unambiguously specify the Data Session object 



Sequence Element N 


1 


1 

1 

i 


lence Element Type 


1 


Sequence Element Description ■ 




DataSessionReference 


IpDataSessionRef 


This element specifies the interface 
reference for the Data Session object. 


DataSessionSessionID 


TpSessionID 


This element specifies the data session ID 
of the Data Session. 



8.5.2.10 TpDataSessionError 

Defines the Sequence of Data Elements that specify the additional information relating to acall error. 



1 


lenuence Element Name i 




^^^^K S^pniipripp FlPinpnt Tvn^^^^^^H 


1 








ErrorTime 


TpDateAndTime 


ErrorType 


TpDataSessionError Type 


AdditionalErrorlnfo 


TpDataSessionAdditionalErrorlnfo 



8.5.2.1 1 TpDataSessionAdditionalErrorlnfo 

Defines the Tagged Choice of Data Elements that specify additional Data Session error and Data Session error 
specific information. 




RMwrarnraimjyii 




miiiiiiiiiii 


P_DATA_SESSION_ERROR_UNDE FINED 


NULL 


Undefined 


P_DATA_SESSION_ERROR_INVALID_ADDRESS 


TpAddressError 


DataSessionErrorlnvalidAddress 


P_DATA_SESSION_ERROR_INVALID_STATE 


NULL 


Undefined 



8.5.2.12 TpDataSessionErrorType 

Defines a specific Data Session error. 
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HI 






Description 




P_DATA_SESSION_ERROR_UNDEFINED 





Undefined; the method failed or 

was refused, but no specific 

reason can be given. 


P_DATA_SESSION_ERROR_INVALID_ADDRESS 


1 


The operation failed because an 
invalid address was given 


P_DATA_SESSION_ERROR_INVALID_STATE 


2 


The data session was not in a 

valid state for the requested 

operation 



8.5.2.13 TpDataSessionFault 

Defines the cause of the data session fault detected. 





i^S^Hr 




P_DATA_SESSION_FAULT_UNDEFINED 





Undefined 


P_DATA_SESION_USER_ABORTED 


1 


User has finalised the data session before any 
message could be sent by the application 


P_DATA_SESSION_TIMEOUT_ON_RELEASE 


2 


This fault occurs when the final report has 

been sent to the application, but the application 

did not explicitly release data session object, 

within a specified time. 

The timer value is operator specific. 


P_DATA_SESSION_TIMEOUT_ON_INTERRUPT 


3 


This fault occurs when the application did not 

instruct the gateway how to handle the call 

within a specified time, after the gateway 

reported an event that was requested by the 

application in interrupt mode. 

The timer value is operator specific. 



8.5.2.14 TpDataSessionReleaseCause 

Defines the Sequence of Data Elements that specify the cause of the release of a data session. 



^^^^^^^^^KkPniipnrp FJpmprit Namp .^^^^^^^^H 


^^^^H. Spniipnrp Flptnprit Tvn^^^^^^H 


1 




Value 


Tplnt32 


Location 


Tplnt32 



Note: the Value and Location are specified as in ITU-T recommendation Q.850. 



8.5.2.15 TpDataSessionSuperviseVolume 

Defines the Sequence of Data Elements that specify the amount of volume that is allowed to be transmitted for the 
specific connection. 



VolumeQuantity 



Tplnt32 



This data type is identical to a Tplnt32, 
and defines the quantity of the granted 
volume that can be transmitted for the 

specific connection. The volume specifies 

the sum of uplink and downlink transfer 

data volumes. 



VolumeUnit 



Tplnt32 



In Order to enlarge the range of the volume 

quantity value the exponent of a scaling 

factor (lO^VolumeUnit ) is provided. 

When the unit is for example in kilobytes, 
VolumeUnit must be set to 3. 
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8.5.2.16 TpDataSessionSuperviseReport 

Defines the responses from the data session control service for calls that are supervised. The values may be combined 
by a logical 'OR' function. 









P_DATA_SESSION_SUPERVISE_VOLUME_REACHED 


Olh 


The maximum volume has been reached. 


P_DATA_SESSION_SUPERVISE_DATA_SESSION_ENDED 


02h 


The data session has ended, either due to data 

session party to reach of maximum volume or 

caUing or called release. 


P_DATA_SESSION_SUPERVISE_MESSAGE_SENT 


04h 


A warning message has been sent. 



8.5.2.1 7 TpDataSessionSuperviseTreatment 

Defines the treatment of the call by the data session control service when the supervised volume is reached. The values 
may be combined by a logical 'OR' function. 



icg^B 


"^^Jl" 




Description 










P_DATA_SESSION_SUPERVISE_RELEASE 


Olh 


Release the data session when the data session 
supervision volume is reached. 


P_DATA_SESSION_SUPERVISE_RESPOND 


02h 


Notify the appHcation when the call 
supervision volume is reached. 


P_DATA_SESSION_SUPERVISE_INFORM 


04h 


Send a warning message to the originating 

party when the maximum volume is reached. If 

data session release is requested, then the data 

session will be released following the message 

after an administered time period 



8.5.2.18 TpDataSession Report 

Defines the Sequence of Data Elements that specify the data session report specific information. 







*« 




^^^j^^^^KK 




jquence i^iemeni 




MonitorMode 


TpDataSessionMonitorMode 


DataSessionEventTime 


TpDateAndTime 


DataSessionReportType 


TpDataSessionReportType 


AdditionalReportlnfo 


TpDataSessionAdditionalReportlnfo 



8.5.2.19 TpDataSessionAdditionalReportlnfo 

Defines the Tagged Choice of Data Elements that specify additional data session report information for certain types of 
reports. 







Tag Element Ty^^ 








TpDataSessionReportType 















bice Element JName 


P_DATA_SESSION_REPORT_UNDE FINED 


NULL 


Undefined 


P_DATA_SESSION_REPORT_CONNECTED 


NULL 


Undefined 


P_DATA_SESSION_REPORT_DISCONNECT 


TpDataSessionReleaseCause 


DataSessionDis connect 
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8.5.2.20 TpDataSessionReportRequest 
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Defines the Sequence of Data Elements that specify the criteria relating to data session report requests. 





^^^^H S^pniipripp FlPinpnt Tvn^^^^^^H 


1 




MonitorMode 


TpDataSessionMonitorMode 


DataSessionReportType 


TpDataSessionReportType 



8.5.2.21 TpDataSessionReportRequestSet 

Defines a Numbered Set of Data Elements of TpDataSessionReportRequest. 

8.5.2.22 TpDataSessionReportType 

Defines a specific data session event report type. 



■ H^g 










\ 


' Description ' 


1 


P_DATA_SESSION_REPORT_UNDEFINED 





Undefined 


P_DATA_SESSION_REPORT_CONNECTED 


1 


Data session established. 


P_DATA_SESSION_REPORT_DISCONNECT 


2 


Data session disconnect 
requested by data session party 



8.5.2.23 TpDataSessionEventCriteriaResultSetRef 

Defines a refernce to TpDataSessionEventCriteriaResultSet. 

8.5.2.24 TpDataSessionEventCriteriaResultSet 

Defines a set of TpDataSessionEventCriteriaResult. 

8.5.2.25 TpDataSessionEventCriteriaResult 

Defines a sequence of data elements that specify a requested call event notification criteria with the associated 
assignmentlD. 



Sequence Element 
Name 
L 


Sequence Element 
Type 


Sequence Element Description 


EventCriteria 


TpDataSessionEventCrit 
eria 


The event criteria that were specified by 
the application. 


AssignmentlD 


Tplnt32 


The associated assignementID . This can be 
used to disable the notification. 



8.6 



Network User Location and User Status Data definitions 



8.6.1 Interface Definitions 

8.6.1.1 IpAppUserStatus 

Defines the address of an IpAppUserStatus Interface. 

8.6.1.2 IpAppUserStatusRef 

Defines a reference to type IpAppUserStatus. 
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8.6.1.3 IpUserStatus 

Defines the address of an IpUserStatus Interface. 

8.6.1 .4 IpAppUserLocationCamel 

Defines the address of an IpAppUserLocationCamel Interface. 

8.6.1 .5 IpAppUserLocationCamelRef 

Defines a reference to type IpAppUserLocationCamelRef. 

8.6.1 .6 IpUserLocationCamel 

Defines the address of an IpUserLocationCamel Interface. 

8.6.2 Common Data Definitions for Network User Location and User 
Status 

The constants and types defined in the following sections are defined in the org.threegpp.osa.mm package. 

8.6.2.1 TpGeographicalPosition 

Defines the structure of data elements that specify a geographical position. 

An "ellipsoid point with uncertainty shape" defines the horizontal location. The reference system chosen for the coding 
of locations is the World Geodetic System 1984 (WGS 84). 

TypeOfUncertaintyShape describes the type of the uncertainty shape and Longitude/Latitude defines the position of the 
uncertainty shape. The following table defines the meaning of the data elements that describe the uncertainty shape for 
each uncertainty shape type. 
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Type of 

uncertainty 

shape 


Uncertainty 
Outer 
Semi 
Major 


Uncertainty 
Outer 
Semi 
Minor 


Uncertainty 
Inner 
Semi 
Major 


Uncertainty 
Inner 
Semi 
Minor 


Angle Of 
Semi Major 


Segment 
Start Angle 


Segment End 
Angle 


None 


- 


- 


- 


- 


- 


- 


- 


Circle 


radius of 
circle 














Circle 
Sector 


radius of 
circle 










start angle of 

circle 

segment 


end angle of 

circle 

segment 


Circle Arc 
Stripe 


radius of 
outer circle 




radius of 
inner circle 






start angle of 

circle arc 

stripe 


end angle of 

circle arc 

stripe 


Ellipse 


length of 

semi-major 

axis 


length of 

semi-minor 

axis 






rotation of 

ellipse 
measured 
clockwise 
from north 






Ellipse 
Sector 


length of 

semi-major 

axis 


length of 

semi-minor 

axis 






rotation of 

ellipse 
measured 
clockwise 
from north 


start angle of 
ellipse 
segment 


end angle of 
ellipse 
segment 


Ellipse Arc 
Stripe 


length of 

semi-major 

axis, outer 

ellipse 


length of 

semi-minor 

axis, outer 

ellipse 


length of 

semi-major 

axis, inner 

ellipse 


length of 

semi-minor 

axis, inner 

ellipse 


rotation of 

ellipse 
measured 
clockwise 
from north 


start angle of 

ellipse arc 

stripe 


end angle of 

ellipse arc 

stripe 



i 


L 








North 


outer 
semi-major 


angle of 
semi major 




£ 


IXIS 










^^ 


inner semi- ^^ 


/ \ start angle 


y^ 


major axis ^ 




//\ 


/^ 


|\ 




1 1 / 


V^-7^ 


1 1 


segment 


1 / 


yf^ / 


^^^^Jl^ end angle 


\ \c 


^^inner /C 




\ / ^ ^ 


semi-minor >^ 


\ 




\/ 


axis >^ 






"^^ ^ 


^-""^^ outer 






£ 


ixis 







Figure 8-1 : Description of an Ellipse Arc 
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Structured Member Name 




J 


Structured Member Type | 




Longitude 


TpFloat 


Latitude 


TpFloat 


TypeOf Uncertainty Shape 


TpLo cat ionUncertainty Shape 


UncertaintylnnerSemiMa jor 


TpFloat 


UncertaintyOuterSemiMa jor 


TpFloat 


Uncertainty I nnerSemiMinor 


TpFloat 


UncertaintyOuterSemiMinor 


TpFloat 


AngleOf SemiMa jor 


Tplnt32 


Segment St art Angle 


Tplnt32 


Segment EndAngle 


Tplnt32 
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8.6.2.2 TpLocationUncertaintyShape 

Defines the type of uncertainty shape. 



mm 


Am 








1 


Liescripnoni 




P_M_SHAPE_NONE 





No uncertainty shape present. 


P_M_SHAPE_CIRCLE 


1 


Uncertainty shape is a circle. 


P_M_SHAPE_CIRCLE_SECTOR 


2 


Uncertainty shape is a circle sector. 


P_M_SHAPE_CIRCLE_ARC_STRIPE 


3 


Uncertainty shape is a circle arc stripe. 


P_M_S HAP E_E L L I P S E 


4 


Uncertainty shape is an ellipse. 


P_M_SHAPE_ELLIPSE_SECTOR 


5 


Uncertainty shape is an ellipse sector. 


P_M_SHAPE_ELLIPSE_ARC_STRIPE 


6 


Uncertainty shape is an ellipse arc stripe. 



8.6.2.3 TpMobilityDiagnostic 

Defines a diagnostic value that is reported in addition to an error by the Network User Location or User Status service 
capabiHty feature. 



Name Value Description 




P_M_NO_INFORMATION 





No diagnostic information present. VaUd for all type of errors. 


P_M_APPL_NOT_IN_PRIV_EXCEPT_LST 


1 


Application not in privacy exception list. Valid for 'Unauthorised 
Application' error. 


P_M_CALL_TO_USER_NOT_SETUP 


2 


Call to user not set-up. VaUd for 'Unauthorised AppHcation' error. 


P_M_PRIVACY_OVERRIDE_NOT_APPLIC 


3 


Privacy override not applicable. Valid for 'Unauthorised Application' error. 


P_M_D I SALL_BY_LOCAL_REGULAT_REQ 


4 


Disallowed by local regulatory requirements. Valid for 'Unauthorised 
Application' error. 


P_M_CONGESTION 


5 


Congestion. Valid for 'Position Method Failure' error. 


P_M_INSUFFICIENT_RESOURCES 


6 


Insufficient resources. Valid for 'Position Method Failure' error. 


P_M_INSUFFICIENT_MEAS_DATA 


7 


Insufficient measurement data. Valid for 'Position Method Failure' error. 


P_M_INCONSISTENT_MEAS_DATA 


8 


Inconsistent measurement data. Valid for 'Position Method Failure' error. 


P_M_LOC_PROC_NOT_COMPLETED 


9 


Location procedure not completed. VaUd for 'Position Method Failure' 
error. 


P_M_LOC_PROC_NOT_SUPBY_USER 


10 


Location procedure not supported by user. VaUd for 'Position Method 
Failure' error. 


P_M_QOS_NOT_ATTAINABLE 


11 


QuaHty of service not attainable. VaUd for 'Position Method Failure' error. 
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8.6.2.4 TpMobilityError 

Defines an error that is reported by the Network User Location or User Status service capabiHty feature. A fatal error 
occurring during the life of periodic or triggered user location/status requests (triggeredstatusReportErr, 

triggeredLocationReportErr or periodicLocationReportErr) will terminate the request SUCh that any particular 

request is allowed to generate at most one fatal error but possibly several non fatal errors. 



■^t^mi^ jL^vui^ 


1 


Descrip^ffl 




Hd 


P_M_OK 





No error occurred while processing the request. 


N/A 


P_M_SYSTEM_FAILURE 


1 


System failure. 

The request can not be handled because of a general problem in 

the Network User Location or User Status SCF or the underlying 

network. 


Yes 


P_M_UNAUTHORIZED_NETWORK 


2 


Unauthorised network, 

The requesting network is not authorised to obtain the user's 

location or status. 


No 


P_M_UNAUTHORIZED_APPLICATION 


3 


Unauthorised application. 

The application is not authorised to obtain the user's location or 

status. 


Yes 


P_M_UNKNOWN_SUBSCRIBER 


4 


Unknown subscriber. 
The user is unknown, i.e. no such subscription exists. 


Yes 


P_M_ABSENT_SUBSCRIBER 


5 


Absent subscriber. 
The user is currently not reachable. 


No 


P_M_POSITION_METHOD_FAILURE 


6 


Position method failure. 

The Network User Location SCF failed to obtain the user's 

position. 


No 



8.6.2.5 TpMobilityStopAssignmentData 

Defines the structure of data elements that specifies a request to stop whole or parts of an assignment. Assignments are 
used for periodic or triggered reporting of a user locations or statuses. 

Observe that the parameter "users" is optional. If the parameter "stopScope" is set to P_M_ALL_IN_ASSIGNMENT, 
the parameter "stopScope" is undefined. If the parameter "stopScope" is set to P_M_SPECIFIED_USERS, then the 
assignment shall be stopped only for the users specified in the "users" collection. 



Structure Element Name 


Structure Element Type 


Description ^^^ 


f 


Assignment Id 


TpSessionID 


Identity of the session that shall be stopped. 


StopScope 


TpMobilityStopScope 


Specify if only a part of the assignment or if whole the assignment 
shall be stopped. 


Users 


TpAddressSet 


Optional parameter describing which users a stop request is 
addressing when only a part of an assignment is to be stopped. 



8.6.2.6 TpMobilityStopScope 

This enumeration is used in requests to stop mobihty reports that are sent from the Network User Location service 
capabiHty feature to an appHcation. 



WM 


^^^^BT 




Description 






^.AW^J. 




P_M_ALL_IN_ASSIGNMENT 





The request concerns all users in an 
assignment. 


P_M_SPECIFIED_USERS 


1 


The request concerns only the users that are 
explicitly specified in a collection. 



ETSI 



3G TS 29.198 version 3.0.0 Release 1999 



115 



ETSI TS 129 198 V3.0.0 (2000-06) 



8.6.3 Network User Location Data Definitions 

The constants and types defined in the following sections are defined in the org.threegpp.osa.mm.ul package. 

8.6.3.1 TpLocationCelllDOrLAI 

This data type is identical to a TString. It specifies the Cell Global Identification or the Location Area Identification 
(LAI). 

The Cell Global Identification (CGI) is defined as the string of characters in the following format: 

MCC-MNC-LAC-CI 

where: 



MCC 
MNC 
LAC 
CI 



Mobile Country Code (three decimal digits) 
Mobile Network Code (two or three decimal digits) 
Location area code (four hexadecimal digits) 
Cell Identification (four hexadecimal digits) 



The Location Area Identification (LAI) is defined as a string of characters in the following format: 



MCC-MNC-LAC 

where: 



MCC 
MNC 
LAC 



Mobile Country Code (three decimal digits) 
Mobile Network Code (two or three decimal digits) 
Location area code (four hexadecimal digits) 



The length of the parameter indicates which format is used. See 3G TS 29.002 for the detailed coding. 



8.6.3.2 TpLocationTriggerCamel 

Defines the structure of data elements that specifies the criteria for a triggered location report to be generated. 



Structure Member ] 


) , 


., , 


Licture Member 1 

1 


\ 




Description 




Update Ins ideVlr 


TpBoolean 


Generate location report when it occurs an location update 
inside the current VLR area. 


UpdateOutsideVlr 


TpBoolean 


Generate location report when the user moves to another VLR 
area. 



8.6.3.3 TpUserLocationCamel 

Defines the structure of data elements that specifies the location of a mobile telephony user. Observe that if the 
statusCode is indicating an error, then neither geographicalPosition, t ime s t amp , vl rNumbe r , 
locationNumber, cellldOrLai nor their associated presense flags are defined. 











- — 


Structure Member Name Structure Member 

J - 


\ 




Description 


1 


UserlD 


TpAddress 


The address of the user. 


StatusCode 


TpMobilityError 


Indicator of error. 


GeographicalPositionPresent 


TpBoolean 


Flag indicating if the geographical position is present. 


GeographicalPosition 


TpGeographicalPosition 


Specification of a position and an area of uncertainty. 


Time St ampP re sent 


TpBoolean 


Flag indicating if the timestamp is present. 


Time St amp 


TpDateAndTime 


Timestamp indicating when the location information 
was attained . 


VlrNumberPresent 


TpBoolean 


Flag indicating if the VLR number is present. 


VI rNumbe r 


TpAddress 


Current VLR number for the user. 
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VocationNumberPresent 


TpBoolean 


Flag indicating if the location number is present. 


LocationNumber' 


TpAddress 


Current location number. 


Cell IdOrLaiP resent 


TpBoolean 


Flag indicating if cell-id or LAI of the user is present. 


CellldOrLai 


TpLocationCelllDOrLAI 


Cell-id or LAI of the user. 



8.6.3.4 TpUserLocationCamelSet 

Defines a collection of TUserLocationCamel 



8.7 



User Status Data Definitions 



The constants and types defined in the following sections are defined in the org.threegpp.osa.mm.us package. 

8.7.1.1 TpUserStatus 

Defines the structure of data elements that specifies the identity and status of a user. 



Structure Element I 






icture Element 1 






Description 


1 


UserlD 


TpAddress 


The user address. 


StatusCode 


TpMobilityError 


Indicator of error. 


Status 


TpUserStatus Indicator 


The current status of the user. 



8.7.1.2 TpUserStatusSet 

Defines a collection of TUserStatus. 

8.7.1 .3 TpUserStatuslndicator 

Defines the status of a user. 



1 ^^^^H 


^^^Jp 


1 


Description 










P_US_REACHABLE 





User is reachable 


P_US_NOT_REACHABLE 


1 


User is not reachable 


P_US_BUSY^ 


2 


User is busy (only applicable for interactive 
user status request, not when triggers are used) 



8.8 Terminal Capabilities Data Definitions 

8.8.1 Interface Definitions 

8.8.1 .1 IpTerminalCapabilities 

Defines the address of an IpTerminalCapabilities Interface. 

8.8.1 .2 IpTerminalCapabilitiesRef 

Defines a reference to type IpTerminalCapabilities 



' The location number is the number to the MSC or in rare cases the roaming number. 
Only applicable to mobile (Wireless) telephony users. 
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8.8.2 Terminal Capabilities Data Definitions 

The constants and types defined in the following sections are defined in the org.threegpp.osa.termcap package. 

8.8.2.1 terminalldentity 

Identifies the terminal. 



1 BSgQJl 


fBIB 


1 


Documentatioi 










terminalldentity 


TpString 


Identifies the terminal. It may be a logical address 
known by the WAP Gateway/PushProxy. 



8.8.2.2 TpTerminalCapabilities 

This data type is a Sequence_of_Data_Elements that describes the terminal capabilities. It is a structured type that 
consists of: 



^■Sequence Elemei 






Sequence Elemen 






Documentation 

L 1 




■^^^^^^^^^■LifjnTf!^^^^ 






^^^^^■l kIRVT^^H^^ 




1^ 










StatusCode 


TpBoolean 


Indicates whether or not the terminalCapabilities 
are available. 


TerminalCapabilities 


TpServicePropertyList 


Specifies the latest available capabilities of the 
user's terminal. 

This information, if available, is returned as 
CC/PP headers as specified in W3C [12] and 
adopted in the WAP UAProf specification [13]. It 
contains URLs; terminal attributes and values, in 
RDF format; or a combination of both. 



8.8.2.3 TpTerminalCapabilitiesError 

Defines an error that is reported by the Terminal Capabilities SCF. 



■C^Q 












uescripiion- 




P_TERMCAP_ERROR_UNDEF INED 





Undefined. 


P_TERMCAP_INVALID_TERMINALID 


1 


The request can not be handled because the terminal id specified 
is not valid. 


P_TERMCAP_SYSTEM_FAILURE 


2 


System failure. 

The request cannot be handled because of a general problem in 

the terminal capabilities service or the underlying network. 
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IDL Interface Definitions 



The OS A API definitions have been divided into several CORBA modules. The common data definitions are placed in 
the root module while each of the specific service capability feature API definitions are being assigned their own 
module directly under that root. Each specific SCF functions, like User Status, have their data and interface definitions 
collocated. This structure has the advantage that explicit scoping is kept to a minimum. 

The IDLs defined for the specific SCFs assumes that the OSA common definitions (interfaces and data) are provided in 
the org.threegpp.osa module within a file name called OSA.idl 



Module Name 


Description 


IDL file name 


org.threegpp.osa 


Common data/interface definitions 


OSA.idl 


org.threegpp.osa.mm 


Common mobility data definitions (root) 


MM.idl 


org.threegpp.osa.mm.ul 


Network User Location (UL) 


MMul.idl 


org.threegpp.osa.mm.us 


User Status (US) 


MMus.idl 


org.threegpp.osa.ee 


Call Control 


CC.idl 


org.threegpp.osa.ui 


User Interaction 


Ul.idl 


org.threegpp.osa.termcap 


Terminal Capabilities 


TERMCAP.idl 



9.1 



Generic IDL 



#ifndef OSA_DEFINED 

#define OSA_DEFINED 

module org 
{ 

module threegpp 

{ 

module osa 



/••7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr7lr^ 



// 



Primitive data types 



/i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^i^^ 



typedef boolean TpBoolean; 

typedef long Tplnt32; 

typedef float TpFloat; 

typedef string TpString; 



// Defines a Boolean data type 

// Defines a signed 32 bit integer 

// Defines a single precision real number. 

// Defines a string comprising length and data. 



// Primitive based OSA datatypes 

typedef Tplnt32 TpDuration; // This data type is a Tplnt32 representing a 

// time interval in milliseconds. A value of "-1" defines 



ETSI 



3G TS 29.1 98 version 3.0.0 Release 1 999 119 ETSI TS 1 29 1 98 V3.0.0 (2000-06) 

// infinite duration and a value of "-2" represents default 
// duration. 

typedef Tplnt32 TpSessionID; // Defines a network unique session ID. OSA 

// uses this ID to identify sessions, e.g. call or call leg 

// sessions, within an object implementing an interface 

// capable of handling multiple sessions. For the different 

// OSA service capability feature, the sessionlDs are unique 

// only in the context of a manager instantiation (e.g., within 

// the context of one generic call control manager) . As such 

// if an application creates two instances of the same SCF 

// manager it shall use different instantiations of the 

// callback objects which implement the callback interfaces. 

typedef Tplnt32 TpAssignmentID; // This data type is identical to a Tplnt32. It 

// specifies a number which identifies an individual 
// event notification enabled by the application or 
// OSA service capability feature. 

typedef sequence < TpSessionID> TpSessionlDSet ; 

// Defines the general Parlay exception values 

enum TpGeneralExceptionType 

{ 

P_RESULT_INFO_UNDEFINED, // No further information present 
P_INVALID_APPLICATION_ID, // Invalid application ID 
P_INVALID_CLIENT_CAP ABILITY, // Invalid client capability 
P_INVALID_AGREEMENT_TEXT, // Invalid agreement text 
P_INVALID_SIGNING_ALGORITHM, // Invalid signing algorithm 
P_INVALID_INTERFACE_NAME, // Invalid interface name 

P_INVALID_SERVICE_ID, // Invalid service capability feature ID 
P_INVALID_EVENT_TYPE, // Invalid event type 
P_SERVICE_NOT_ENABLED, // The SCF ID does not correspond 

// to a SCF that has been enabled 
P_INVALID_ASSIGNMENT_ID, // The assignment ID does not 

// correspond to one of the valid assignment IDs 
P_INVALID_PARAMETER, // The method has been called with an 

// invalid parameter 
P_INVALID_PARAMETER_VALUE, //A method parameter has an invalid value 
P_PARAMETER_MISSING, // A required parameter has not been 

// specified in the method call 
P_RE SOURCE S_UNAVAILABLE, // The required resources in the 

// network are not available 
P_TASK_REFUSED, // The requested method has been refused 
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P_TASK_CANCELLED, // The requested method has been cancelled 

P_INVALID_DATE_TIME_FORMAT, // Invalid date and time format provided 
P_NO_CALLBACK_ADDRESS_SET, // The requested method has been refused 

// because no callback address is set 
P_INVALID_TERMINATION_TEXT, // Invalid termination text 
P_INVALID_SERVICE_TOKEN, // The SCF token does not correspond to a 

// token that had been issued, or the issued token 

// has expired. 
P_INVALID_AUTHENTICATION, // The client has not been correctly authenticated 
P_INVALID_SERVICE_PROPERTY, // Invalid service capability feature property. 
P_METHOD_NOT_SUPPORTED // The method is not allowed or supported within 

// the context of the current SCF agreement. 



exception TpGeneralException 
{ 

TpGeneralExceptionType except ionType; 



// Defines the GCCS OSA exception values 

enum TpGCCSExceptionType 

{ 

P_GCCS_SERVICE_INFORMATION_MISSING, // Information relating to the Call 

// Control SCF could not be found 
P_GCCS_SERVICE_FAULT_ENCOUNTERED, // Fault detected in the Call Control SCF 
P_GCCS_UNEXPECTED_SEQUENCE, // Unexpected sequence of methods, i.e., 
// the sequence does not match the specified 
// state diagrams for the call or the call leg. 
P_GCCS_INVALID_ADDDRESS, // Invalid address specified 
P_GCCS_INVALID_STATE, // Invalid state specified 
P_GCCS_INVALID_CRITERIA, // Invalid criteria specified 
P_GCCS_INVALID_NETWORK_STATE, // Although the sequence of method calls is 
// allowed by the OSA gateway, the underlying 
// protocol can not support it. E.g., in some 
// protocols some methods are only allowed by 
// the protocol, when the call processing is 
// suspended, e.g., after reporting an event 
// that was monitored in interrupt mode. 
P_GCCS_NETWORK_DEASSIGN // The relation between the network and the OSA 
// gateway is terminated. Therefore, the gateway 
// can no longer influence the call. This can happen 
// after the last requested report is sent to the 
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// application. To prevent this error, the application 
// should ensure that it has requested events which 
// are not yet reported. 

}; 

exception TpGCCSException 
{ 

TpGCCSExceptionType except ionType; 

}; 

// Defined the GUIS OSA exception values 

enum TpGUISExceptionType 

{ 

P_GUIS_INVALID_CRITERIA, // Invalid criteria specified 
P_GUIS_ILLEGAL_ID, // Information id specified is invalid 
P_GUIS_ID_NOT_FOUND, // A legal information id is not known to the User 

// Interaction SCF 
P_GUIS_ILLEGAL_RANGE, // The values for minimum and maximum collection 

// length are out of range. 
P_GUIS_INVALID_COLLECTION_CRITERIA, // Invalid collection criteria specified 
P_GUIS_NETWORK_DEASSIGN, // The relation between the network and the OSA 
// gateway is terminated. Therefore, the gateway 
// can no longer perform UI operations. This can 
// happen after the last requested report is sent 
// to the application. To prevent this error, the 
/// application should ensure that it has requested 
// events which are not yet reported. 
P_GUIS_INVALID_NETWORK_STATE // Although the sequence of method calls is 
// allowed by the OSA gateway, the underlying 
// protocol can not support it. E.g., in some 
// protocols some methods are only allowed by 
// the protocol, when the call processing is 
// suspended, e.g., after reporting an event 
// that was monitored in interrupt mode. 



exception TpGUISException 
{ 

TpGUISExceptionType except ionType; 

}; 
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/ -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k -k Date and Time related data definitions ^^^^^^^^^^^^^/ 

// This data type is identical to a TpString. It specifies the data in 

// accordance with International Standard ISO 8601. This is defined as the 

// string of characters in the following format: 

// YYYY-MM-DD 

// where the date is specified as: 

// YYYY four digits year 

// MM two digits month 

// DD two digits day 

// The date elements are separated by a hyphen character (-) . 

typedef TpString TpDate; 

// This data type is identical to a TpString. It specifies the time in accordance 

// with International Standard ISO 8601. This is defined as the string of 

// characters in the following format: 

// HH:MM:SS.mmm 

// or 

// HH:MM:SS.mmmZ 

// where the time is specified as: 

// HH two digits hours (24h notation) 

// MM two digits minutes 

// SS two digits seconds 

// mmm three digits fractions of a second (i.e. milliseconds) 

// The time elements are separated by a colon character (:) .The date and time 

// are separated by a space. Optionally, a capital letter Z may be appended 

// to the time field to indicate Universal Time (UTC) . Otherwise, local time 

// is assumed. 

typedef TpString TpTime; 

// This data type is identical to TosaString. It specifies the data and time 

// in accordance with International Standard ISO 8601. This is defined as the 

// string of characters in the following format: 

// 

// YYYY-MM-DD HH:MM:SS.mmm 

// or YYYY-MM-DD HH :MM: SS .mmmZ 

// 

// Example: 

// The 4 December 1998, at 10:30 and 15 seconds is encoded as the string: 

// 1998-12-04 10:30:15.000 
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// for local time, or in UTC it would be: 
// 1998-12-04 10:30:15. OOOZ 

typedef TpString TpDateAndTime; 

// Address related data definitons 

// Defines whether an address can be presented to an end user 
enum TpAddressPresentation 

{ 

P_ADDRESS_PRESENTATION_UNDEFINED, // Undefined 

P_ADDRESS_PRESENTATION_ALLOWED, // Presentation Allowed 

P_ADDRESS_PRESENTATION_RESTRICTED, // Presentation Restricted 

P_ADDRESS_PRESENTATION_ADDRESS_NOT_AVAILABLE // Address not available for 

// presentation 

}; 

// Defines whether an address has been screened by the application 

enum TpAddressScreening 

{ 

P_ADDRESS_SCREENING_UNDEFINED, // Undefined 

P_ADDRESS_SCREENING_USER_VERIFIED_PASSED, // user provided address verified 

// and passed 

P_ADDRESS_SCREENING_USER_NOT_VERIFIED, // user provided address not verified 

P_ADDRESS_SCREENING_USER_VERIFIED_FAILED, // user provided address verified and 

// failed 

P_ADDRESS_SCREENING_NETWORK // Network provided address 

}; 

// Defines the address plan (or numbering plan) used. It is also used to indicate 
// whether an address is actually defined in a TAddress data element 
enum TpAddressPlan 



P_ADDRESS_PLAN_NOT_PRESENT, // No Address Present 



P_ADDRESS_PLAN_UNDEFINED, 

P_ADDRESS_PLAN_IP, 

P_ADDRESS_PLAN_MULTICAST, 

P_ADDRESS_PLAN_UNICAST, 

P_ADDRESS_PLAN_E164, 

P_ADDRESS_PLAN_E164_MOBILE, // E.164 Mobile 

P_ADDRESS_PLAN_AESA, // AESA 



// Undefined 

// IP 

// Multicast 

// Unicast 

// E.164 
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P_ADDRESS_PLAN_URL, // URL 

P_ADDRESS_PLAN_NSAP, // NSAP 

P_ADDRESS_PLAN_SMTP, // SMTP 
P_ADDRESS_PLAN_NOT_USED, 

P_ADDRESS_PLAN_X4 // X.4 00 

}; 
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// Defines the reasons why an address is invalid. 

enum TpAddressError 

{ 

P_ADDRESS_INVALID_UNDEFINED, // Undefined error 

P_ADDRESS_INVALID_MISSING, // Mandatory address not present 

P_ADDRESS_INVALID_MISSING_ELEMENT, // Mandatory address element not present 

P_ADDRESS_INVALID_OUT_OF_RANGE, // Address is outside of the valid range 

P_ADDRESS_INVALID_INCOMPLETE, // Address is incomplete 

P_ADDRESS_INVALID_CANNOT_DECODE // Address cannot be decoded 

}; 

// Defines the structure of data elements that specifies an address 

struct TpAddress 

{ 

TpAddressPlan plan; 

TpString astring; 

TpString name; 

TpAddressPresentation presentation; 

TpAddressScreening screening; 

TpString subAddressString; 



// Defined a collection of TpAddress elements 
typedef sequence < TpAddress> TpAddressSet ; 

// Defined a collection of TpAddress elements 
typedef TpAddress TpAddressRange; 

// This data type is identical to a TpString and contains a URL address, 
typedef TpString TpURL; 

// This data type is identical to a TpString. It specifies price information. 
// This is defined as the string of characters (digits) in the following format: 
// DDDDDD.DD 
typedef TpString TpPrice; 
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struct TpChargePerTime { 

Tplnt32 InitialCharge; /^Initial charge amount (in currency units * 0.0001)*/ 
Tplnt32 CurrentChargePerMinute; /* Current tariff (in currency units * 0.0001)*/ 
Tplnt32 NextChargePerMinute; /* Next tariff (in currency units * 0.0001) after tariff switch 
Only used in set AdviceOf Charge () */ 

}; 

enum TpAoCOrderCategory { 

P_CHARGE_ADVICE_INFO, /* Set of GSM Charge Advice Information elements according to 3G TS 22.024*/ 

P_CHARGE_PER_TIME, /* Charge per time*/ 

P_CHARGE_NETWORK /* Operator specific charge plan specification, e.g. charging table name / 
charging table entry*/ 

}; 

/* Defines the Sequence of Data Elements that specify theCharging Advice Information elements 
according to 3G TS 22.024.*/ 

struct TpCAIElements { 

Tplnt32 UnitsPerlnterval; /* Units per interval */ 
Tplnt32 SecondsPerTimelnterval; /* Seconds per time interval */ 
Tplnt32 ScalingFactor; /* Scaling factor */ 
Tplnt32 Unitlncrement; /* Unit increment */ 

Tplnt32 UnitsPerDatalnterval; /* Units per data interval */ 
Tplnt32 SegmentsPerDatalnteral; /* Segments per data interal */ 
Tplnt32 InitialSecsPerTimelnterval; /* Initial sees per time interval */ 
In- 
struct TpChargeAdviceInf o { 

TpCAIElements CurrentCAI ; /* Current tariff*/ 

TpCAIElements NextCAI ; /* Next tariff after tariff switch*/ 

}; 

/* Defines the Tagged Choice of Data Elements that specify the charge plan */ 
union TpAoCOrder switch (TpAoCOrderCategory) { 
case P_CHARGE_ADVICE_INFO: 

TpChargeAdviceInf o ChargeAdviceInf cr- 
ease P_CHARGE_PER_TIME: 

TpChargePerTime ChargePerTime; 
case P_CHARGE_NETWORK: 

TpString NetworkCharge; 
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In- 
struct TpAoCInfo { 

TpAoCOrder ChargeOrderType; /* Charge order*/ 

TpString Currency; /* Currency unit according to 130-4217:1995*/ 



}; 
}; 

#endif 



// base OSA interface 

// All application, framework and service capability features interfaces inherit 
// from the following interface. This API Base Interface does not provide any 
// additional methods, 
interface IpOsa 
{ 

}; 

// All service capability feature interfaces inherit from the following interface. 

interface IpService : IpOsa 

{ 

// This method specifies the reference address of the callback interface 

// that a SCF uses to invoke methods on the application. 

void setCallback (in IpOsa applnterf ace) raises (TpGeneralException) ; 
}; 



9.2 Framework IDL 



9.2.1 Common Data Types for the Framework 

#include <OSA.idl> 
module org{ 
module threegpp{ 
module osa{ 

module fw{ 
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typedef TpString TpClientAppID; // Identifies the client appl to the framework. 

typedef sequence <TpClientAppID> TpClientAppIDList ; 

typedef TpString TpEntOpID; 

typedef sequence < TpEntOpID > TpEntOpIDList ; 

typedef TpString TpServicelD; // A string of characters, generated automatically by the 

// Framework and comprising a TpUniqueServiceNumber, 

// TpServiceNameString, and a number of relevant 

// TpServiceSpecString, concatenated using a forward 

// separator (/) , that uniquely identifies an instance of a 

// SCF interface. 

typedef sequence <TpServiceID> TpServicelDList ; 

typedef TpString TpServiceNameString; // Uniquely identifies the name of an SCF 

// interface. For OSA release 99 the following 
// values have been defined: NULL (no SCF name) , 
/ / P_CALL_CONTROL, P_USER_INTERACTION, 
// P_USER_LOCATION, P_TERMINAL_CAP ABILITIES and 
// P_USER_STATUS. 

typedef TpString TpServiceSpecString; // Uniquely identifies the name of a SCF 

// specialisation interface. For OSA release 99 

// the following values have been defined: NULL 

// no SCF specialisation) and P_CALL . 



typedef TpString TpUniqueServiceNumber; // A string of characters that represents a 

// unique number, 
enum TpServicePropertyMode { 

NORMAL, // The value of the corresponding SCF property type may optionally be 

// provided. 
MANDATORY, // The value of the corresponding SCF property type must be provided 

// at SCF registration. 
READONLY, // The value of the corresponding SCF property is optional, nut once 

// given a value it may not be modified. 
MANDATORY_READONLY // The value of the corresponding SCF property type must be provided 

// and may not be modified subsequently. 

}; 



ETSI 



3G TS 29.1 98 version 3.0.0 Release 1 999 1 28 ETSI TS 1 29 1 98 V3.0.0 (2000-06) 

typedef TpString TpServicePropertyTypeName; 

typedef TpString TpServicePropertyName; 

typedef sequence <TpServicePropertyName> TpServicePropertyNameList ; 

typedef TpString TpServicePropertyValue; 

typedef sequence <TpServicePropertyValue> TpServicePropertyValueList ; 

struct TpServiceProperty { // Describes a SCF property 

TpServicePropertyName ServicePropertyName; 
TpServicePropertyValueList ServicePropertyValueList ; 
TpServicePropertyMode ServicePropertyMode; 

}; 

typedef sequence <TpServiceProperty> TpServicePropertyList ; 
typedef TpString TpServiceTypeName; 

typedef sequence <TpServiceTypeName> TpServiceTypeNameList ; 

struct TpService { // Describes a registered SCF. 

TpServicelD ServicelD; 
TpServicePropertyList ServicePropertyList ; 

}; 

typedef sequence <TpService> TpServiceList ; 

struct TpServiceDescription { // Describes the properties of a registered SCF. 

TpServiceTypeName ServiceTypeName; 

TpServicePropertyList ServicePropertyList; 
In- 
struct TpPropertyStruct { // Describes a SCF property. 

TpServiceTypeName ServicePropertyName; 

TpServicePropertyMode ServicePropertyMode; 

TpServicePropertyTypeName ServicePropertyTypeName; 
}; 

typedef sequence <TpPropertyStruct> TpPropertyStructList ; 
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struct TpServiceTypeDescription { // Describes a SCF type. 
TpPropertyStructList PropertyStructList ; 
TpServiceTypeNameList ServiceTypeNameList ; 
TpBoolean EnabledOrDisabled; 

}; 



9.2.2 Service Discovery IDL 

#include <fw.idl> 

module org{ 
module threegpp{ 
module osa{ 
module fw{ 
module discovery! 

// Interface definitions // 

/-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

/* The Service Discovery Framework interface is used by the client application to 
know what types of services are supported by the Framework, and what are their 
properties; and to obtain the services its subscription allows access to. */ 
interface IpServiceDiscovery : IpOsa { 

/^ This method is invoked by the client application to obtain the names of all service 
types that are in the Framework repository. */ 
void listServiceTypes ( 

out TpServiceTypeNameList listTypes // The names of the requested service types. 
) raises (TpGeneralException) ; 

/^ This method is invoked by the client application to obtain the detailed description of 

a particular service type. '^ / 

void describeServiceType ( 

in TpServiceTypeName name, // Identifies the service 

// type to be described, 
out TpServiceTypeDescription serviceTypeDescription // Describes the specified 



// service type. 



) raises (TpGeneralException) ; 
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/* This method is invoked by the client application to obtain the IDs of the services 

that meet its requirements. '^ / 

void discoverService ( 

in TpServiceTypeName serviceTypeName, // Type of the required service. 

in TpServicePropertyList desiredPropertyList , // Properties that the discovered set 

// of SCFs should satisfy. 

// Maximum number of SCFs that are 

// to be returned. 

// A list of matching SCFs. 



in Tplnt32 max. 



out TpServiceList serviceList 



) raises (TpGeneralException) ; 

/* This method is invoked by the client application to obtain a list of subscribed 

SCFs that they are allowed to access. */ 

void listSubscribedServices ( 

out TpServiceList serviceList // A list of subscribed SCFs. 

) raises (TpGeneralException) ; 



}; 



};};};};}; 



9.2.3 Trust and Security Management IDL 

#include <fw.idl> 



module org{ 

module threegpp{ 

module osa{ 

module fw{ 

module trust_and_security { 



// Data definitions // 



typedef TpString 



TpAccessType; // The type of access interface requested by the client 
// application. For OSA release 99 the following values 
// have been defined: NULL (indicates the default access 
// type) and P_ACCESS. 
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typedef TpString TpAuthType; 



// The type of authentication mechanism requested by the 

// client. For OSA release 99 the following values have 

// been defined: NULL (indicates OSA authentication) , 

/ / P_AUTHENTICATION (indicates use of the OSA 

// authentication interfaces. 



typedef TpString TpAuthCapability; 



// The authentication capabilities that could be supported 

// by the OSA. For OSA release 99 the following values 

// have been defined: NULL (indicates no client 

// capabilities, P_DES_5 6, P_RSA_512 and P_RSA_102 4) . 



typedef TpString 



TpAuthCapabilityList; // A string of multiple TpAuthCapability 

// concatenated using a commas. 



typedef TpString 



Tplnterf aceName; // Identifies the names of the framework SCFs that are be 

// supported by the OSA API. For release 99 these are NULL, 

// P_DISCOVERY, P_OAM, P_TRUST_AND_SECURITY_MANAGEMENT 

// P_INTEGRITY_MANAGEMENT. 



struct TpServiceAccessControl { 

TpString Policy; // Access control policy information controlling access to the 

// service feature. 
TpString TrustLevel; // The level of trust that the network operator has assigned to the 

// client application. 
}; 

typedef TpString TpServiceToken; // Uniquely identifies a SCF . 

struct TpSignatureAndServiceMgrRef { 

TpString DigitalSignature; // The digital signature of the Framework for the service 

// agreement. 
IpOsa ServiceMgrlnterf ace; 

}; 



typedef TpString TpSigningAlgorithm; 



// Identifies the signing algorithm that must be 

// used. For OSA release 99 the follwing values have 

// been defined: NULL (indicates no signing algorithm 

// is required), P_MD5_RSA_512 and P_MD5_RSA_102 4 . 
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struct TpFwAuth { 
TpFwID FwID; 
IpOsa FwAuthlnterf ace; 
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/■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k^ 

// Interface definitions // 



/* The Initial Framework interface is used by the client application to initiate the mutual 
authentication with the Framework and, when this is finished successfully, to request access 
to it. */ 
interface Iplnitial : IpOsa { 

/* This method is invoked by the client application to start the process of mutual 

authentication with the framework, and request the use of a specific authentication method. 

*/ 

void initiateAuthentication ( 

in TpClientAppID clientAppID, 

in TpAuthType authType, 

in IpOsa appAuthlnterf ace, 

out TpFwAuth fwAuthlnterface 

) raises (TpGeneralException) ; 



// Identifies the client to the framework. 

// Allows the client application to request a 

// specific type of authentication mechanism. 

// Provides a reference to the client application 

// authentication interface. 

// Provides a framework identifier, and a reference 

// to framework authentication interface. 



/* This method is invoked by the client application, once mutual authentication is 
achieved, to request access to the framework and specify the type of access desired. ^/ 
void requestAccess ( 
in TpAccessType accessType, // Identifies the type of access interface requested by 

// the client application, 
in IpOsa appAccessInterf ace, // Provides a reference to the access interface of the 

// client application, 
out IpOsa fwAccessInterf ace // Provides a reference to call the access interface of 

// the framework. 
) raises (TpGeneralException) ; 
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}; 



/* The Access Framework interface is used by the client application to perform the mechanisms 
necessary for it to obtain access to SCFs. '^ / 
interface IpAccess : IpOsa { 

/* This method is invoked by the client application to obtain interface references to other 

framework interfaces. '^ / 

void obtainlnterface ( 

in Tplnterf aceName interf aceName, // The name of the framework interface to which a 

// reference to the interface is requested, 
out IpOsa fwlnterface // The requested interface reference. 

) raises (TpGeneralException) ; 



/* This method is invoked by the client application to obtain interface references to other 

framework interfaces, when it is required to supply a callback interface to the framework. 
V 



void obtainlnterf aceWithCallback ( 
in Tplnterf aceName interf aceName, 

in IpOsa applnterf ace, 

out IpOsa fwlnterface 

) raises (TpGeneralException) ; 



// The name of the framework interface to which 

// a reference to the interface is requested. 

// This is the reference to the client application 

// interface which is used for callbacks. 

// The requested interface reference. 



/^ This method may be invoked by the client application to check whether it has been 

granted permission to access the specified SCF and, if granted, the level of trust that 

will be applied. */ 

void accessCheck ( 

in TpString securityContext , // A group of security relevant 

// attributes. 

in TpString securityDomain, // The security domain in which 

// the client application is 
// operating. 

in TpString group, // Used to define the access 

// rights associated with all 
// clients that belong to that 
// group. 

in TpString serviceAccessTypes, // Defined by the specific 
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// security model in use. 

// The access control policy 

// information controlling 

// access to the service 

// capability feature, and the 

// trustLevel that the network 

// operator has assigned to the client 

// application. 



) raises (TpGeneralException) ; 



/* This method is invoked by the client application to identify the SCF that it wishes 
to use. '^ / 



void selectService ( 

in TpServicelD servicelD, 

in TpServicePropertyList serviceProperties, 

out TpServiceToken serviceToken 
) raises (TpGeneralException) ; 



// Identifies the SCF. 

// List the properties that the SCF 

// should support. 

// A free format text token returned by 

// the framework, which can be signed as 

// part of a service agreement. 



/* This method is invoked by the client application to request that the framework sign an 

agreement on the SCF, which allows the client application to use the SCF. ^/ 

void signServiceAgreement ( 

in TpServiceToken serviceToken, // Used to identify the SCF 

// instance requested by the 
// client application. 
// The agreement text to be 
// signed by the framework. 
// The algorithm used to compute 
// the digital signature. 
// A reference to a structure 
// that contains the digital 
// signature of the framework 
// for the service agreement, 
// and a reference to the 
// SCF manager interface of 
// the SCF. 

) raises (TpGeneralException) ; 



in TpString agreementText , 



in TpSigningAlgorithm signingAlgorithm, 



out TpSignatureAndServiceMgrRef signatureAndServiceMgr 
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/* This method is invoked by the client application to terminate an agreement for the 

specified SCF. ^/ 

void terminateServiceAgreement ( 

in TpServiceToken serviceToken, // Identifies the service agreement to be terminated. 

in TpString terminationText , // Describes the reason for the termination of the 

// service agreement, 
in TpString digitalSignature // Used by the framework to check that the 

// terminationText has been signed by the client. 
) raises (TpGeneralException) ; 

/* This method is invoked by the client application to end the access session 

with the Framework. ^/ 

void endAccess () raises (TpGeneralException); 



/* The Access client application interface is used by the Framework to perform the steps that 
are necessary in order to allow it to SCF access. '^ / 
interface IpAppAccess : IpOsa { 

/* This method is invoked by the Framework to request that client application sign an 
agreement on a specified SCF. */ 



void signServiceAgreement ( 

in TpServiceToken serviceToken, 

in TpString agreementText , 

in TpSigningAlgorithm signingAlgorithm, 

out TpString digitalSignature 

) raises (TpGeneralException) ; 



// Identifies the SCF instance to which 

// this service agreement corresponds. 

// Agreement text that has to be signed by the 

// client application. 

// Algorithm used to compute the digital 

// signature. 

// Signed version of a hash of the service 

// token and agreement text given by the 

// framework. 



/* This method is invoked by the Framework to terminate an agreement for a specified 

SCF. ^/ 

void terminateServiceAgreement ( 

in TpServiceToken serviceToken, // Identifies the SCF agreement to be terminated. 
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// Describes the reason for the termination. 
// Used by the Framework to confirm its identity to the 
// client. 



/* This method is invoked by the Framework to end the client application's access session 

with the framework. */ 

void terminateAccess ( 

in TpString terminationText , // Describes the reason for the termination of 

// the access session, 
in TpSigningAlgorithm signingAlgorithm, // The algorithm used to compute the digital 

// signature, 
in TpString digitalSignature // Used by the Framework to confirm its 

// identity to the client. 
) raises (TpGeneralException) ; 



}; 



/* The Authentication Framework interface is used by client application to perform its part of 
the mutual authentication process with the Framework necessary to be allowed to use any of the 
other interfaces supported by the Framework. */ 
interface IpAuthentication : IpOsa { 

/* This method is invoked by the client application to start the authentication process, 
informed the Framework of the authentication mechanisms it supports, and be informed by its 
of its preferred choice. */ 



void selectAuthMethod ( 

in TpAuthCapabilityList authCapability, 



out TpAuthCapability prescribedMethod 



) raises (TpGeneralException) ; 



// Informs the Framework of the authentication 

// mechanisms supported by the client 

// application. 

// Indicates the mechanism preferred by the 

// framework. 



/* This method is invoked by the client application to authenticate the framework using the 

mechanism indicated in the parameter prescribedMethod. '^ / 

void authenticate ( 

in TpAuthCapability prescribedMethod, // Specifies the method accepted by that the 
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out TpString response 



) raises (TpGeneralException) ; 
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// framework for authentication. 
// The challenge presented by the client 
// application to be responded to by the 
// framework. 

// The response of the framework to the 
// challenge of the client application. 



/* This method is invoked by the client application to to abort the authentication 

process . */ 

void abortAuthentication ( ) raises (TpGeneralException); 



}; 



/* The Authentication client application interface is used by the Framework to authenticate 
the client application. */ 

interface IpAppAuthentication : IpOsa { 

/* This method is invoked by the Framework to authenticate the client application using the 

mechanism indicated in prescribedMethod. '^ / 

void authenticate ( 

in TpAuthCapability prescribedMethod, // The agreed authentication method. 

in TpString challenge, // The challenge presented by the Framework. 

out TpString response 

) raises (TpGeneralException) ; 

/^ This method is invoked by the Framework to abort the authentication process. '^ / 
void abortAuthentication ( ) raises (TpGeneralException); 



};};};};}; 



9.2.4 Integrity Management IDL 

#include <fw.idl> 
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module org{ 
module threegppj 
module osa{ 
module fw{ 
module integrity{ 
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/^ 



V 



// Data definitions // 



typedef TpString TpActivityTestRes; // An implementation specific result, whose values 

// are Framework provider specific. 

struct TpTimelnterval { // A time interval. 
TpDateAndTime StartTime; 
TpDateAndTime StopTime; 

}; 



enum Tplnterf aceFault { // The cause of the interface fault detected. 
INTERFACE_FAULT_UNDEFINED, // Undefined. 

INTERFACE_FAULT_LOCAL_FAILURE, // A fault in the local API software or hardware has been 

// detected. 
INTERFACE_FAULT_GATEWAY_FAILURE, //A fault in the gateway API software or hardware has been 

// detected. 
INTERFACE_FAULT_PROTOCOL_ERROR // An error in the protocol used on the client-gateway link 

// has been detected. 



struct TpFaultStatsSet { // Statistics on a per fault type basis. 
TpInterfaceFault Fault; 
Tplnt32 Occurrences; // The number of separate instances of this fault 

// during the period. 

// The duration in seconds of the longest fault. 

// The cumulative total during the period. 



Tplnt32 
Tplnt32 
Tplnt32 



MaxDuration; 
TotalDuration; 



NumberOfClientsAf fected; // Those informed of the fault by the Framework. 



In- 



struct TpFaultStatsRecord { // The set of fault information records to be returned for the 

// requested time period. 
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typedef Tplnt32 TpActivityTestID; 



// Used as a token to match activity test requests 
// with their results. 



enum TpSvcUnavailReason { // The reason why a SCF is unavailable. 

SERVICE_UNAVAILABLE_UNDEFINED, // Undefined. 

SERVICE_UNAVAILABLE_LOCAL_FAILURE, // The local API software or hardware has failed. 
SERVICE_UNAVAILABLE_GATEWAY_FAILURE, // The gateway API software or hardware has failed. 
SERVICE_UNAVAILABLE_OVERLOADED, // The SCF is fully overloaded. 
SERVICE_UNAVAILABLE_CLOSED // The SCF has closed itself. 



enum TpAPIUnavailReason { 

API_UNAVAILABLE_UNDEFINED, 

API_UNAVAILABLE_LOCAL_FAILURE, 

API_UNAVAILABLE_GATEWAY_FAILURE, 

API_UNAVAILABLE_OVERLOADED, 

API_UNAVAILABLE_CLOSED, 

API_UNAVAILABLE_PROTOCOL_FAILURE 

}; 



// The reason why the API is unavailable. 

// Undefined. 

// The local API software or hardware has failed. 

// The gateway API software or hardware has failed. 

// The gateway is fully overloaded. 

// The gateway has closed itself. 

// The protocol used on the client-gateway link has failed. 



enum TpLoadLevel { 

LOAD_LEVEL_NORMAL , 
LOAD_LEVEL_OVERLOAD , 



// The load level values. 
// Normal load. 
// Overload. 



LOAD_LEVEL_SEVERE_OVERLOAD 



// Severe overload. 



In- 



struct TpLoadThresholdj // The load threshold value. 
TpFloat LoadThreshold; 
In- 



struct TpLoadlnitVal { // The pair of load level and associated load threshold values. 
TpLoadLevel LoadLevel; 
TpLoadThreshold LoadThreshold; 
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struct TpLoadPolicy { // The load balancing policy. 

TpString LoadPolicy; 
In- 
struct TpLoadStatistic { // The load statistic record at given timestamp. 

TpServicelD ServicelD; 

TpFloat LoadValue; // Expressed in percentage. 

TpLoadLevel LoadLevel; 

TpDateAndTime TimeStamp; 
}; 

typedef sequence <TpLoadStatistic> TpLoadStatisticList ; 

enum TpLoadStatusError { // The error code for getting the load status. 

LOAD_STATUS_ERROR_UNDEFINED, // Undefined error. 
LOAD_STATUS_ERROR_UNAVAILABLE // Unable to get the load status. 



struct TpLoadStatisticError { // The error for getting the load status at given timestamp. 
TpServicelD ServicelD; 
TpFloat LoadStatusError; 
TpDateAndTime TimeStamp; 



typedef sequence <TpLoadStatisticError> TpLoadStatisticErrorList ; 



// Interface definitions // 

/* The Heartbeat Framework interface is used by the client application to supervise the 
Framework or a SCF . ^/ 
interface IpHeartBeat : IpOsa { 

/* This method is invoked by the client application to make the service or Framework 

supervision. ^/ 

void send ( 

in TpSessionID session // The heartbeat session. 
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) raises (TpGeneralException) ; 



/* The Heartbeat client application interface is used by the Framework to supervise the client 

application. */ 

interface IpAppHeartBeat : IpOsa { 

/* This method is invoked by the Framework to make the client application supervision. */ 

void send ( 

in TpSessionID session // The heartbeat session. 

) raises (TpGeneralException) ; 



/* The Heartbeat Management Framework interface is used by the client application to 
initialise a heartbeat supervision of the client application. */ 
interface IpHeartBeatMgmt : IpOsa { 

/* This method is invoked by the client application to register at the Framework for 

heartbeat supervision. ^/ 

void enableHeartBeat ( 

in TpDuration duration, // Duration in milliseconds between heartbeats. 

in IpAppHeartBeat applnterf ace, // The callback interface the heartbeat is calling. 

out TpSessionID session // The heartbeat session. 

) raises (TpGeneralException) ; 

/* This method is invoked by the client application to stop its heartbeat supervision. */ 

void disableHeartBeat ( 

in TpSessionID session // The heartbeat session. 

) raises (TpGeneralException) ; 

/* This method is invoked by the client application to change the heartbeat period. */ 

void changeTimePeriod ( 

in TpDuration duration, // Duration in milliseconds between heartbeats. 

in TpSessionID session // The heartbeat session. 

) raises (TpGeneralException) ; 
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/* The Heartbeat Management client application interface is used by the Framework to 
initialise its heartbeat supervision of the Framework. */ 
interface IpAppHeartBeatMgmt : IpOsa { 



/* This method is invoked by the Framework to register at the client application for its 
heartbeat supervision. */ 



void enableAppHeartBeat ( 

in TpDuration duration, 

in IpHeartBeat fwlnterface, 

in TpSessionID session 

) raises (TpGeneralException) ; 



// Time interval in milliseconds between the heartbeats. 
// The callback interface the heartbeat is calling. 
// The heartbeat session. 



/* This method is invoked by the Framework to stop the heartbeat supervision by the 

application. */ 

void disableAppHeartBeat ( 

in TpSessionID session // The heartbeat session. 

) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to change the heartbeat period. '^ / 

void changeTimePeriod ( 

in TpDuration duration, // Interval in milliseconds between the heartbeats. 

in TpSessionID session // The heartbeat session. 

) raises (TpGeneralException) ; 



}; 



/* The Load Manager Framework interface is used by the client application for load balancing 

management. '^ / 

interface IpLoadManager : IpOsa { 

/* This method is invoked by the client application to notify framework its current load 
level (0,1, or 2) when the load level on the application has changed. '^ / 
void reportLoad ( 

in TpClientAppID requester, // The identifier of the client application for 

// callbacks from the load balancing SCF. 
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in TpLoadLevel loadLevel // The application's load level. 
) raises (TpGeneralException) ; 

/* This method is invoked by the client application to request load statistic records for 

the framework and specified SCFs. '^ / 

void queryLoadReq ( 

in TpClientAppID requester, // The identifier of the client application for 

// callbacks from the load balancing SCF. 
in TpServicelDList servicelDs, // Specifies the framework and SCFs for which the 

// load statistics shall be reported, 
in TpTimelnterval timelnterval // The time interval within which the load statistics 

// are generated. 
) raises (TpGeneralException) ; 

/* This method is invoked by the client application to report load statistics back to the 

framework that requested the information. ^/ 

void queryAppLoadRes ( 

in TpLoadStatisticList loadStatistics // The application's load statistics. 

) raises (TpGeneralException) ; 

/* This method is invoked by the client application to return an error response to the 

framework that requested the application's load statistics information. ^/ 

void queryAppLoadErr ( 

in TpLoadStatisticErrorList loadStatisticsError // The error code associated with the 

// failed attempt to retrieve the 
// application's load statistics. 

) raises (TpGeneralException) ; 

/* This method is invoked by the client application to register the client application for 

load management under various load conditions. '^ / 

void registerLoadController ( 

in TpClientAppID requester, // Identifies the client application for callbacks 

// from the load balancing SCF. 
in TpServicelDList servicelDs // Specifies the framework and SCFs to be 

// registered for load control. 
) raises (TpGeneralException) ; 

/* This method is invoked by the client application to unregister for load management. '^ / 

void unregisterLoadController ( 

in TpClientAppID requester, // Identifies the client application for callbacks from 
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// the load balancing SCF. 

// Specifies the framework or SCFs to be 

// unregistered for load control. 



/* This method is invoked by the client application to resume load management notifications 

to it from the framework and specified SCFs. */ 

void resumeNotif ication ( 

in TpServicelDList servicelDs // Specifies the framework and SCFs for which 

// notifications are to be resumed. 
) raises (TpGeneralException) ; 

/* This method is invoked by the client application to suspend load management 

notifications to it from the framework and specified SCFs, while it handles a temporary 

load condition. */ 

void suspendNotif ication ( 

in TpServicelDList servicelDs // Specifies the framework and SCFs for which 

// notifications are to be suspended. 
) raises (TpGeneralException) ; 



/* The Load Manager client application interface is used by the Framework to access the 
application load balancing SCF. ^/ 
interface IpAppLoadManager : IpOsa { 

/* This method is invoked by the Framework to request for load statistic records produced 

by a specified application. ^/ 

void queryAppLoadReq ( 

in TpServicelDList servicelDs, // Specifies the SCFs or application for which the 

// load statistics shall be reported, 
in TpTimelnterval timelnterval // The time interval within which the load statistics 

// are generated. 
) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to return load statistics to the application 
which requested the information. */ 
void queryLoadRes ( 
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in TpLoadStatisticList loadStatistics // The load statistics supplied by the 

// Framework. 
) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to return an error code to the application that 

requested load statistics. */ 

void queryLoadErr ( 

in TpLoadStatisticErrorList loadStatisticsError // The error code supplied by the 

// Framework. 
) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to disable load control activity at the client 

application based on policy, after the load level of the Framework or SCF which has 

been registered for load control moves back to normal. */ 

void disableLoadControl ( 

in TpServicelDList servicelDs // Specifies the framework and SCFs for which the 

// load has changed to normal. 
) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to enable load management activity at the client 

application based on the policy, upon detecting load condition change. '^ / 

void enableLoadControl ( 

in TpLoadStatisticList loadStatistics // The new load statistics. 

) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to resume the notification from an application 
for its load status after the detection of load level change at the Framework and the 
evaluation of the load balancing policy. */ 
void resumeNotif ication ( ) raises (TpGeneralException); 

/^ This method is invoked by the Framework to suspend the notification from an application 
for its load status after the detection of load level change at the Framework and the 
evaluation of the load balancing policy. '^ / 
void suspendNotif ication ( ) raises (TpGeneralException); 



/* The Fault Manager Framework interface is used by the client application to inform the 
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Framework of events that affect the integrity of the Framework and SCFs, and to request 
information about the integrity of the system. */ 
interface IpFaultManager : IpOsa { 

/* This method may be invoked by the client application to test that the Framework or a 
SCF is operational. */ 



void activityTestReq ( 

in TpActivityTestID activityTestID, 



in TpServicelD svcID, 



in TpClientAppID appID 



) raises (TpGeneralException) ; 



// Identifier provided by the client 

// application to correlate the 

// response with this request. 
// Identifies for which SCF the client 
// application is requesting the activity test 
// be done. 

// Identifies which client application is 
// requesting the activity test (and therefore 
// which application receives the results) . 



/* This method is invoked by the client application to return the result of a previously 

requested activity test. '^ / 

void appActivityTestRes ( 

in TpActivityTestID activityTestID, // Used by the Framework to correlate this 

// response with the original request, 
in TpActivityTestRes activityTestResult // Result of the activity test. 
) raises (TpGeneralException) ; 

/* This method is invoked by the client application to inform the Framework that it can no 

longer use the indicated SCF. */ 

void svcUnavailableInd ( 

in TpServicelD servicelD, // Identity of the SCF which can no longer be used. 

in TpClientAppID appID // Identity of the application sending the indication. 

) raises (TpGeneralException) ; 

/* This method is invoked by the client application to request fault statistics from the 

Framework. */ 

void genFaultStatsRecordReq ( 

in TpTimelnterval timePeriod, // The period over which the fault statistics 

// are to be generated, 

in TpServicelDList servicelDList , // The SCFs that the application would like 

// to have included in the general fault 
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in TpClientAppID appID 



) raises (TpGeneralException) ; 



// statistics record. 

// Identifies which client application is 

// requesting the statistics record (and 

// therefore should receive it) . 



/* The Fault Manager client application interface is used by the Framework to inform the 
application of events that affect the integrity of the Framework, SCF or client 
application. */ 
interface IpAppFaultManager : IpOsa { 

/* This method is invoked by the Framework, in response to an activityTestReq, to return 

the result of the activity test in this method. '^ / 

void activityTestRes ( 

in TpActivityTestID activityTest ID, // The identifier provided to correlate this 

// response with the original request, 

in TpActivityTestRes activityTestResult // Result of the activity test. 
) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to request that the client application carries 

out an activity test to check that is it operating correctly. */ 

void appActivityTestReq ( 

in TpActivityTestID activityTestID // The identifier provided to correlate this 

// response with the original request. 
) raises (TpGeneralException) ; 

/^ This method is invoked by the Framework to notify the client application of a failure 

within the Framework. */ 

void fwFaultReportInd ( 

in TpInterfaceFault fault // The fault that has been detected. 

) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to notify the client application that a 

previously reported fault has been rectified. '^ / 

void fwFaultRecoveryInd ( 

in TpInterfaceFault fault // The fault from which the framework has recovered. 
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) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to inform the client application that it can no 

longer use the indicated SCF due to a failure. '^ / 

void svcUnavailableInd ( 

in TpServicelD servicelD, // Identity of the SCF which can no longer be used. 

in TpSvcUnavailReason reason // The reason why the SCF is no longer available. 

) raises (TpGeneralException) ; 

/* This method is invoked by the Framework to provide fault statistics to a client 
application in response to a genFaultStatsRecordReq. '^ / 

void genFaultStatsRecordRes ( 

in TpFaultStatsRecord f aultStatistics, // The fault statistics record. 

in TpServicelDList servicelDs // The SCFs that have been included in the 



// general fault statistics record. 



) raises (TpGeneralException) ; 



/^ The 0AM Framework interface is used by the client application to query the system date and 
time, for synchronisation purposes. */ 
interface IpOAM : IpOsa { 

/^ This method is invoked by the client application to interchange the system an client 

application date and time. */ 

void systemDateTimeQuery ( 

in TpDateAndTime clientDateAndTime, // The date and time of the client. 

out TpDateAndTime systemDateAndTime // The date and time of the system. 

) raises (TpGeneralException) ; 



}; 



/* The 0AM client application interface is used by the Framework to query the application date 
and time, for synchronisation purposes. '^ / 
interface IpAppOAM : IpOsa { 
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/* This method is invoked by the Framework to interchange the system an client application 

date and time. */ 

void systemDateTimeQuery ( 

in TpDateAndTime systemDateAndTime, // The date and time of the system. 

out TpDateAndTime clientDateAndTime // The date and time of the client. 

) raises (TpGeneralException) ; 



}; 



9.2.4 Registration IDL 

#include <fw.idl> 

module org{ 

module threegppj 

module osa{ 

module fw{ 

module registration! 

// Interface definitions // 

/^ The Service Registration Framework interface provides the methods used for the registration 
of network SCFs at the Framework. */ 
interface IpServiceRegistration : IpOsa { 

/^ This method is used to register a SCF in the Framework, for subsequent discovery by 

the applications. '^ / 

void registerService ( 

in TpServiceTypeName serviceTypeName, 

in TpServicePropertyList servicePropertyList , 

out TpServicelD servicelD 

) raises (TpGeneralException) ; 

/* This method informs the Framework of the availability of a service factory for a 
previously registered SCF. ^/ 
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void announceServiceAvailability ( 
in TpServicelD servicelD, 
in IpOsa serviceFactory 

) raises (TpGeneralException) ; 

/* This method is used to remove a registered SCF from the Framework. */ 

void unregisterService ( 

in TpServicelD servicelD 

) raises (TpGeneralException) ; 

/* This method is used to ebtain the decription of a certain SCF as it was registered in 

the Framework. ^/ 

void describeService ( 

in TpServicelD servicelD, 

out TpServiceDescription serviceDescription 

) raises (TpGeneralException) ; 



}; 



/* The Service Factory Framework interface provides the Framework with access to a manager 
interface of a network SCF to be given to an application. */ 
interface IpSvcFactory : IpOsa { 

/* This method returns an SCF manager interface reference for a specified application. 
V 

void getServiceManager ( 

in TpClientAppID application, 

out IpOsa serviceManager 

) raises (TpGeneralException) ; 



9.3 Call Control 

9.3.1 Common Data Types for Call Control 

// source file: CC.idl 

// Generic Call Data description 

#ifndef OSA_CC_DEFINED 

#define OSA_CC_DEFINED 

#include <OSA.idl> 

module org 
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module threegpp 



module osa 



module cc 
{ 

/* Defines the mechanism that will be used to alert a called party. '^ / 

typedef Tplnt32 TpCallAlertingMechanism; 



the bearer service associated with the call. '^ / 
IBearer Service 



/^ Defines 
enum TpCal 
{ 

P_CALL_BEARER_SERVICE_UNKNOWN, 



P_CALL_BEARER_SERVICE_SPEECH, 

P_CALL_BEARER_SERVICE_DIGITALUNRESTRICTED, 

P_CALL_BEARER_SERVICE_DIGITALRESTRICTED, 

P_CALL_BEARER_SERVICE_AUDIO, 

P_CALL_BEARER_SERVICE_DIGITALUNRESTRICTEDTONES, 



P_CALL_BEARER_SERVICE_VIDEO 



/* Bearer capability information 
unknown at this time*/ 
/* Speech*/ 

/* Unrestricted digital information*/ 
/* Restricted digital information*/ 
/* 3.1 kHz audio*/ 
/* Unrestricted digital information 

with tones/announcements*/ 
/*Video*/ 



}; 



/*This data defines the bearer capabilities associated with the call. (3G TS 24.002) This 
information is network operator specific and may not always be available because there 
is no standard protocol to retrieve the information */ 

enum TpCallNetworkAccessType 



P_CALL_NETWORK_ACCESS_TYPE_UNKNOWN, 



/* Network type information unknown at this time 



V 



P_CALL_NETWORK_ACCESS_TYPE_POT, /* POTS 
P_CALL_NETWORK_ACCESS_TYPE_ISDN, /* ISDN */ 

P_CALL_NETWORK_ACCESS_TYPE_DIALUPINTERNET, /* Dial-up Internet 
P_CALL_NETWORK_ACCESS_TYPE_XDSL, /* xDSL */ 
P_CALL_NETWORK_ACCESS_TYPE_WIRELESS /* Wireless */ 



/* Defines the category i 


prepaid) . */ 




enum 

r 


TpCallPartyCategory 


i 

P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 


P_ 


_CALL_PARTY_ 


.CATEGORY. 



of a calling or called party (e.g. call priority, payphone. 



.UNKNOWN, 

.OPERATOR_F, 

.OPERATOR_E, 

.OPERATOR_G, 

.OPERATOR_R, 

.OPERATOR_S, 

.ORDINARY_SUB, 

.PRIORITY_SUB, 

.DATA_CALL, 

.TEST_CALL, 

.PAYPHONE 



/*calling party's category unknown at this time*/ 



operator, language French*/ 

operator, language English*/ 

operator, language German*/ 

operator, language Russian*/ 

operator, language Spanish*/ 

/* ordinary calling subscriber*/ 

/* calling subscriber with priority*/ 

/* data call (voice band data) */ 

/* test call*/ 

/* payphone*/ 



}; 



/* This data type defines the tele-service associated with the call. (Q.763: User 
Teleservice Information, Q.931: High Layer Compatitibility Information, and 3G TS 
22 . 003) Defines the tele-service associated with the call (e.g. speech, video, fax, file 
transfer, browsing) . */ 

enum TpCallTeleService 



P_CALL 
P_CALL 
P_CALL 
P_CALL 
P_CALL 
P_CALL 
P_CALL 
or interwork 
P_CALL 
P_CALL 
P_CALL 
P_CALL 
P_CALL 
P_CALL 
P_CALL 
P_CALL 



TELE. 

TELE. 

.TELE. 

.TELE. 

.TELE. 

.TELE. 

.TELE. 

ing u: 

.TELE. 

.TELE. 

.TELE. 

.TELE 

.TELE 

.TELE. 

.TELE. 

.TELE. 



SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 

nits */ 

SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 

SERVICE. 



.UNKNOWN, / 

.TELEPHONY, 

FAX_2_3 , / 

FAX_4_I , / 

.FAX_4_II_III, 

.VIDEOTEX_SYN, 

.VIDEOTEX_INT, 



Teleservice information unknown at this time*/ 

/* Telephony */ 

Facsimile Group 2/3 */ 

Facsimile Group 4, Class I */ 

/* Facsimile Group 4, Classes II and III */ 

/* Syntax based Videotex */ 

/* International Videotex interworking via gateways 



.TELEX, 

.MHS, /-" 

.OSI, /•" 

.FTAM, /^ 

.VIDEO, 

yiDEO_CONF, 

AUD I OGRAP H_CONF , 

.MULTIMEDIA, / 



/* Telex service*/ 

Message Handling Systems */ 

OSI application*/ 

FTAM application*/ 

/* Videotelephony*/ 

/* Videoconferencing*/ 

/* Audiographic conferencing*/ 

Multimedia services*/ 
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p_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


p_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


p_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


active 3. 


1 kHz 


audio o 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 


P_ 


_CALL_ 


_TELE_ 


_SERVICE_ 



/ '^ Capability set of initial channel of H.221*/ 



/ '^ Capability set of subsequent channel of H.221^/ 



CS_INI_H221, 

CS_SUB_H221, 

CS_INI_CALL, /* Capability set of initial channel associated with 

r speech call.*/ 

Data traffic.*/ 
/* Emergency Calls*/ 
Short message MT/PP*/ 
Short message MO/PP*/ 



DATATRAFFIC, /^ 
EMERGENCY_CALLS , 
SMS_MT_PP, /^ 
SMS_MO_PP, /-" 



CELL_BROADCAST, /^ 

ALT_SPEECH_FAX_3, /^ 

AUTOMAT I C_FAX_3, /^ 

yOICE_GROUP_CALL, /^ 

yOICE_BROADCAST /^ 



Cell Broadcast Service*/ 

Alternate speech and facsimile group 3*/ 

Automatic Facsimile group 3*/ 

Voice Group Call Service*/ 

Voice Broadcast Service*/ 



}; 



/* Defines a specific call event report type. */ 

enum TpCallAppInf oType 

{ 

P_CALL_APP_UNDEFINED, /* Undefined */ 

P_CALL_APP_ALERTING_MECHANISM, /* The alerting mechanism or pattern to use */ 
P_CALL_APP_NETWORK_ACCESS_TYPE, /* The network access type (e.g. ISDN) */ 
P_CALL_APP_TELE_SERVICE, /* Indicates the tele-service (e.g. speech) and 

related info such as clearing programme */ 

P_CALL_APP_BEARER_SERVICE, /* Indicates the bearer service (e.g. 64kb/s 

unrestricted data) . */ 

P_CALL_APP_PARTY_CATEGORY, 
P_CALL_APP_PRESENTATION_ADDRESS, 



*/ 



P_CALL_APP_GENERIC_INFO, 



P_CALL_APP_ADDITIONAL_ADDRESS 



/* The category of the calling or called party */ 

/* The address to be presented to other call parties 

/* Carries unspecified application-SCF information 

/* Indicates an additional address */ 



}; 



/* Defines the Tagged Choice of Data Elements that specify call application-related 
specific information. */ 

union TpCallAppInf o switch (TpCallAppInf oType) 
{ 

case P_CALL_APP_TELE_SERVICE: 

TpCallTeleService CallAppTeleService; 

case P_CALL_APP_BEARER_SERVICE: 

TpCallBearer Service CallAppBearer Service; 

case P_CALL_APP_PARTY_CATEGORY: 

TpCallPartyCategory CallAppPartyCategory; 

case P_CALL_APP_PRESENTATION_ADDRESS : 

TpAddress CallAppP resent at lonAddress; 

case P_CALL_APP_GENERIC_INFO: 

TpString CallAppGenericInf o; 

case P_CALL_APP_ADDITIONAL_ADDRESS : 

TpAddress CallAppAdditionalAddress; 

case P_CALL_APP_ALERTING_MECHANISM: 

TpCallAlertingMechanism CallAppAlertingMechanism; 

case P_CALL_APP_NETWORK_ACCESS_TYPE : 

TpCallNetworkAccessType CallAppNetworkAccessType; 



typedef sequence <TpCallAppInf o> TpCallAppInf oSet; 

enum TpCallChargeOrderCategory 
{ 

P_CALL_CHARGE_PER_TIME, /* Charge per time*/ 

P_CALL_CHARGE_NETWORK /* Operator specific charge plan specification, e.g. charging 
table name / charging table entry*/ 
}; 

/* Defines the Tagged Choice of Data Elements that specify the charge plan for the call. */ 

union TpCallChargeOrder switch (TpCallChargeOrderCategory) 



case P_CALL_CHARGE_PER_TIME: TpChargePerTime ChargePerTime; 
case P_CALL_CHARGE_NETWORK: TpString NetworkCharge; 



}; 



/* Defines the Sequence of Data Elements that specify the charge plan for the call This 
data type is identical to a TpString, and defines the call charge plan to be used for the 
call. The values of this data type are operator specific. */ 
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struct TpCallChargePlan 
{ 

TpCallChargeOrder Char geOrder Type; 

TpString Currency; 

TpString Additionalinf o; 

}; 

const Tplnt32 P_EVENT_NAME_UNDEFINED = 0; // Undefined 

const Tplnt32 P_EVENT_GCCS_OFFHOOK_EVENT = 1; // Offhook event 

const Tplnt32 P_EVENT_GCCS_ADDRESS_COLLECTED_EVENT =2; // Address information 

collected 

const Tplnt32 P_EVENT_GCCS_ADDRESS_ANALYSED_EVENT =4; // Address information is 

analysed 

const Tplnt32 P_EVENT_GCCS_CALLED_PARTY_BUSY = 8; // Called party is busy 

const Tplnt32 P_EVENT_GCCS_CALLED_PARTY_UNREACHABLE = 16; // Called party is 

unreachable 

const Tplnt32 P_EVENT_GCCS_NO_ANSWER_FROM_CALLED_PARTY =32; // No answer from called 

party 

const Tplnt32 P_EVENT_GCCS_ROUTE_SELECT_FAILURE =64; // Failure in routing the 

call 

const Tplnt32 P_EVENT_GCCS_ANSWER_FROM_CALL_PARTY =12 8; // Party answered call 

typedef Tplnt32 TpCallEventName; /^Defines the names of event being notified. */ 

enum TpCallNotif IcationType 
{ 

P_ORIGINATING, // The notification is related to the originating user in the call. 
P_TERMINATING // The notification is related to the terminating user in the call. 
In- 
struct TpCallEventCriteria 
{ 

TpAddressRange DestinationAddress; /^Destination address or address range*/ 
TpAddressRange OriginationAddress; /^Origination address or address range */ 
TpCallEventName CallEventName; /^Name of the event (s) */ 

TpCallNotif IcationType CallNotif IcationType; /^Indicates whether the criteria are 
related to the originating or terminating user in the call */ 

}; 

/* Defines a sequence of data elements that specify a requested call event notification 
criteria with the associated assignmentID */ 
struct TpCallEventCriteriaResult 
{ 

TpCallEventCriteria Event Criteria; 

Tplnt32 AssignmentID; 
}; 

/* Defines a set of TpCallEventCriteriaResult */ 

typedef sequence <TpCallEventCriteriaResult> TpCallEventCriteriaResultSet ; 

//Defines the type of notification. 

//Indicates whether it is related to the originating of the terminating user in the call. 

struct TpCallEventlnfo 

{ 

TpAddress DestinationAddress; 

TpAddress OriginatingAddress; 

TpAddress OriginalDestinationAddress; 

TpAddress RedirectingAddress; 

TpCallAppInfoSet CallAppInfo; 

TpCallEventName CallEventName; 

TpCallNoti float ionType CallNotif IcationType; 
}; 

/* Defines the Sequence of Data Elements that specify the cause of the release of a call.^^/ 
struct TpCallReleaseCause { 
Tplnt32 Value; 
Tplnt32 Location; 

}; 

/* Defines the Sequence of Data Elements that specify the reason for the call ending.*/ 

struct TpCallEndedReport 

{ 

TpSessionID CallLegSessionID; 

TpCallReleaseCause Cause; 
}; 

/* Defines a specific call error. */ 
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enum TpCallErrorType 
{ 

P_CALL_ERROR_UNDEFINED, /* Undefined */ 

P_CALL_ERROR_INVALID_ADDRESS, /* The operation failed because an invalid address was 
given ^/ 

P_CALL_ERROR_INVALID_STATE /^ The call was not in a valid state for the requested 
operation */ 
}; 

/^ Defines the Tagged Choice of Data Elements that specify additional call error and call 
error specific information. This is also used to specify call leg errors and call information 
errors. */ 

union TpCallAdditionalErrorInf o switch (TpCallErrorType) 
{ 

case P_CALL_ERROR_INVALID_ADDRESS: TpAddressError CallErrorlnvalidAddress; 
default: short Dummy; // allows initialisation of the union in the default case 

}; 

/* Defines the Sequence of Data Elements that specify the additional information relating 
to an undefined call error. */ 
struct TpCallError 
{ 

TpCallAdditionalErrorInf o AdditionalErrorInf o; 

TpCallErrorType ErrorType; 

TpDateAndTime ErrorTime; 

}; 

/* Defines the cause of the call fault detected. ^/ 

enum TpCallFault 

{ 

P_CALL_FAULT_UNDEFINED, /* Undefined */ 

P_CALL_TIMEOUT_ON_RELEASE, /* Final report has been sent to the application, but the 
application did not explicitly release or deassign the call object, within a specified time. 
V 

P_CALL_TIMEOUT_ON_INTERRUPT /* Application did not instruct the gateway how to handle 
the call within a specified time, after the gateway reported an event that was requested by 
the application in interrupt mode.^^/ 
}; 

/^ Defines the type of call information requested and reported */ 
const Tplnt32 P_CALL_INFO_UNDEFINED = 0; /* Undefined */ 

const Tplnt32 P_CALL_INFO_TIMES = 1; /* Relevant call times */ 

const Tplnt32 P_CALL_INFO_RELEASE_CAUSE = 2; /^ Call release cause. ^/ 

const Tplnt32 P_CALL_INFO_INTERMEDIATE =4; /^ Send only intermediate reports (i.e., 
when a party leaves the call) . '^ / 

typedef Tplnt32 TpCallInf oType; 

/^ Defines the Sequence of Data Elements that specify the call information requested. 
Information that was not requested may be undefined or not present. */ 
struct TpCallInf oReport 
{ 

TpCalllnfoType Callinf oType; 

TpDateAndTime CalllnitiationSt art Time; 

TpDateAndTime CallConnectedToResourceTime; 

TpDateAndTime CallConnectedToDestinationTime; 

TpDateAndTime CallEndTime; 

TpCallReleaseCause Cause; 
}; 

/^ Defines the mode that the call will monitor for events, or the mode that the call is in 
following a detected event. */ 
enum TpCallMonitorMode 
{ 

P_CALL_MONITOR_MODE_INTERRUPT, /^ The call event is intercepted by the call control 
SCF and call processing is interrupted. The application is notified of the event and call 
processing resumes following an appropriate API call or network event (such as a call 
release) */ 

P_CALL_MONITOR_MODE_NOTIFY, /^ The call event is detected by the call control SCF 
but not intercepted. The application is notified of the event and call processing continues 
^/ 

P_CALL_MONITOR_MODE_DO_NOT_MONITOR /* Do not monitor for the event */ 

}; 

/* Defines the type of call overload that has been detected (and possibly acted upon) by 
the network. */ 

enum TpCallOverloadType 
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P_CALL_OVERLOAD_TYPE_UNDEFINED, /^ Infinite interval (do not admit any calls) ^/ 
P_CALL_OVERLOAD_TYPE_NEW_CALLS, /* New calls to the application are causing overload 

(i.e. inbound overload) */ 

P_CALL_OVERLOAD_TYPE_ROUTED_CALLS /^ Calls being routed to destination or origination 

addresses by the application are causing overload (i.e. outbound overload) '^ / 

}; 

/* Defines a specific call event report type. */ 

enum TpCallReportType 

{ 

P_CALL_REPORT_UNDEFINED, /^ Undefined ^/ 

P_CALL_REPORT_PROGRESS, /^ Call routing progress event */ 

P_CALL_REPORT_ALERTING, /^ Call alerting at address ^/ 

P_CALL_REPORT_ANSWER, /^ Call answered at address */ 

P_CALL_REPORT_BUSY, /* Called address refused call due to busy */ 

P_CALL_REPORT_NO_ANSWER, /^ No answer at called address ^/ 

P_CALL_REPORT_DISCONNECT, /^ Call disconnect requested by address */ 

P_CALL_REPORT_REDIRECTED, 

P_CALL_REPORT_SERVICE_CODE, 

P_CALL_REPORT_ROUTING_FAILURE 

}; 

/* Defines the Tagged Choice of Data Elements that specify additional call report 
information. ^/ 

union TpCallAdditionalReportInf o switch (TpCallReportType) 
{ 

case P_CALL_REPORT_BUSY: TpCallReleaseCause RefuseBusy; 

case P_CALL_REPORT_DISCONNECT: TpCallReleaseCause CallDisconnect ; 

case P_CALL_REPORT_REDIRECTED: TpAddress ForwardAddress; 

case P_CALL_REPORT_SERVICE_CODE: TpCallReleaseCause ServiceCode; 

case P_CALL_REPORT_ROUTING_FAILURE: TpCallReleaseCause RoutingFailure; 

default: short Dummy; // allows initialisation of the union in the default case 

}; 

struct TpCallReport 
{ 

TpCallMonitorMode MonitorMode; 

TpDateAndTime CallEventTime; 

TpCallReportType CallReportType; 

TpCallAdditionalReportInf o AdditionalReportInf o; 

}; 

/* Defines the different types of service codes that can be received during the call.'^/ 

enum TpCallServiceCodeType 

{ 

P_CALL_SERVICE_CODE_UNDEFINED, /^ The type of service code is unknown. The 
corresponding string is operator specific. "^7 

P_CALL_SERVICE_CODE_DIGITS, /* The user entered a digit sequence during the call. The 
corresponding string is an ascii representation of the received digits. */ 

P_CALL_SERVICE_CODE_FACILITY, /^ A facility information element is received. The 
corresponding string contains the facility information element as defined in ITU Q.932^/ 

P_CALL_SERVICE_C0DE_U2U, /* A user-to-user message was received. The associated string 
contains the content of the user-to-user information element. '* / 

P_CALL_SERVICE_CODE_HOOKFLASH, /^ The user performed a hookflash, optionally followed 
by some digits. The corresponding string is an ascii representation of the entered digits. '^ / 

P_CALL_SERVICE_CODE_RECALL /* The user pressed the register recall button, optionally 
followed by some digits. The corresponding string is an ascii representation of the entered 
digits. '^ / 

}; 

/* Defines the Sequence of Data Elements that specify the service code and type of service 
code received during a call. The service code type defines how the value string should be 
interpreted. Defines the service code received during a call. For example, this may be a 
digit sequence, user-user information, recall, flash-hook or ISDN Facility Information 
Element. This data type is identical to a TpString. The coding of this data type is operator 
specific. */ 

struct TpCallServiceCode 

{ 

TpCallServiceCodeType CallServiceCodeType; 
TpString ServiceCodeValue; 

}; 

/* Defines the Tagged Choice of Data Elements that specify specific criteria. */ 
union TpCallAdditionalReportCriteria switch (TpCallReportType) 
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case P_CALL_REPORT_NO_ANSWER: TpDuration NoAnswerDuration; 

case P_CALL_REPORT_SERVICE_CODE: TpCallServiceCode ServiceCode; 

default: short Dummy; // allows initialisation of the union in the default case 

}; 

/* Defines the Sequence of Data Elements that specify the criteria relating to call report 
requests. */ 

struct TpCallReportRequest 
{ 

TpCallMonitorMode MonitorMode; 

TpCallReportType CallReportType; 

TpCallAdditionalReport Criteria AdditionalReport Criteria ; 

}; 

/* Defines a Numbered Set of Data Elements of TpCallReportRequest. */ 
typedef sequence <TpCallReportRequest> TpCallReportRequestSet ; 

const Tplnt32 P_CALL_SUPERVISE_TIMEOUT = 1; /^ The call supervision timer has expired. 
V 

const Tplnt32 P_CALL_SUPERVISE_CALL_ENDED =2; /^ The call has ended, either due to timer 
expiry or calling or called party release. In case the called party disconnects but a follow- 
on call can still be made also this indication is used.^^/ 

const Tplnt32 P_CALL_SUPERVISE_TONE_APPLIED =4; /^ A warning tone has been applied. */ 

const Tplnt32 P_CALL_SUPERVISE_UI_F INI SHED = 8; /^ The user interaction has finished */ 

/^ Defines the responses from the call control SCF for calls that are supervised: "^7 
typedef Tplnt32 TpCallSuperviseReport ; 

const Tplnt32 P_CALL_SUPERVISE_RELEASE = 1; /^ Release the call when the call 
supervision timer expires. '^ / 

const Tplnt32 P_CALL_SUPERVISE_RESPOND =2; /^ Notify the application when the call 
supervision timer expires. '^ / 

const Tplnt32 P_CALL_SUPERVISE_APPLY_TONE =4; /^ Send a warning tone to the controlling 
party when the call supervision timer expires. If call release is requested, then the call 
will be released following the tone after an administered time period '^ / 

/* Defines the following treatment of the call by the call control SCF when the call 
supervision timer expires. "^7 

typedef Tplnt32 TpCallSuperviseTreatment ; 

/^ Define the possible Exceptions. '^ / 

const Tplnt32 P_GCCS_SERVICE_INFORMATION_MISSING = 256; 

const Tplnt32 P_GCCS_SERVICE_FAULT_ENCOUNTERED = 257; 

const Tplnt32 P_GCCS_UNEXPECTED_SEQUENCE = 258; 

const Tplnt32 P_GCCS_INVALID_ADDDRESS = 259; 

const Tplnt32 P_GCCS_INVALID_CRITERIA =261; 

const Tplnt32 P_GCCS_INVALID_NETWORK_STATE = 2 62; 

exception TpGCCSException 
{ 

Tplnt32 exceptionType; 

}; 

}; // end module co. 
}; // end module osa 
}; // end module threegpp 
}; // end module org 

#endif 

// END file CC.idl 

9.3.2 Generic Call Control IDL 

// source file: GCC.idl 

// GenericCall Interface description 

#ifndef OSA_CC_GCC_DEFINED 

#define OSA_CC_GCC_DEFINED 

#include <CC.idl> 

module org { 
module threegpp { 
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module osa { 
module cc { 
module gcc { 



interface IpAppCallControlManager; // forward definition 
interface IpAppCall; // forward definition 

/^ This interface is the SCF manager' interface for Generic Call Control. */ 
interface IpCallControlManager : IpService { 

/* This method is used to enable call notifications. */ 
void enableCallNotif ication ( 

in IpAppCallControlManager applnterf ace, 
in TpCallEventCriteria eventCriteria, 
out TpAssignmentID assignmentID 
) 
raises (TpGCCSException, TpGeneralException) ; 

/* This method is used by the application to disable call notifications . ^^7 
void disableCallNotif ication ( 

in TpAssignmentID assignmentID 

) 
raises (TpGCCSException, TpGeneralException) ; 

void changeCallNotif ication ( 

in TpAssignmentID assignmentID, 

in TpCallEventCriteria eventCriteria 

) 
raises (TpGCCSException, TpGeneralException) ; 

void getCriteria ( 

out TpCallEventCriteriaResultSet eventCriteria 

) 
raises (TpGCCSException, TpGeneralException) ; 



/^ This interface provides the means to control a simple call. */ 
interface IpCall : IpService { 

/^ This method requests routing of the call to the destination party. "^7 
void routeReq ( 

in TpSessionID callSessionID, 

in TpCallReportRequestSet responseRequested, 
in TpAddress targetAddress, 
in TpAddress originatingAddress, 
in TpAddress originalDestinationAddress, 
in TpAddress redirectingAddress, 
in TpCallAppInf oSet applnfo, 
out TpSessionID callLegSessionID 
) 
raises (TpGCCSException, TpGeneralException) ; 

/* This method requests the release of the call and associated objects.*/ 
void release ( 

in TpSessionID callSessionID, 

in TpCallReleaseCause cause 

) 
raises (TpGCCSException, TpGeneralException) ; 

/* This method requests that the relationship between the application and 

the call and associated objects be de-assigned. '^ / 
void deassignCall ( 

in TpSessionID callSessionID 

) 
raises (TpGCCSException, TpGeneralException) ; 

/* This method requests information associated with the call.*/ 
void getCallInf oReq ( 

in TpSessionID callSessionID, 

in TpCallInf oType callinf oRequested 

) 
raises (TpGCCSException, TpGeneralException) ; 

/* Set an operator specific charge plan for the call. */ 
void setCallChargePlan ( 

in TpSessionID callSessionID, 

in TpCallChargePlan callChargePlan 

) 
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raises (TpGCCSException, TpGeneralException) ; 

/* The application calls this method to supervise a call. '^ / 
void superviseCallReq ( 

in TpSessionID callSessionID, 

in TpDuration time, 

in TpCallSuperviseTreatment treatment 

) 

raises (TpGCCSException, TpGeneralException) ; 

void setAdviceOfCharge ( 

in TpSessionID callSessionID, 

in TpAoCInfo aOCInfo, 

in TpDuration tariffSwitch 

) 
raises (TpGCCSException, TpGeneralException) ; 

}; 

/* Sequence of Data Elements that unambiguously specify the Generic Call object */ 
struct TpCallldentifier { 

IpCall CallReference; 

TpSessionID CallSessionID; 

}; 

/^ The generic call control manager application interface provides the 

application call control management functions to the generic call control 
SCF. */ 
interface IpAppCallControlManager : IpOsa { 
void callAborted ( 

in TpSessionID callRef erence 
) 
raises (TpGCCSException, TpGeneralException) ; 

/^ This method notifies the application of the arrival of a call-related event. */ 
void callEventNotify ( 

in TpCallldentifier callRef erence, 

in TpCallEventInf o eventlnfo, 

in TpAssignmentID assignmentID, 

out IpAppCall applnterface 

) 
raises (TpGCCSException, TpGeneralException) ; 

/^ This method indicates to the application that all event notifications 
have been terminated .'^ / 
void callNotif icationlnterrupted () 

raises (TpGCCSException, TpGeneralException) ; 

void callNotif icationContinued () 

raises (TpGCCSException, TpGeneralException) ; 



/^ The application side of the simple call interface is used to handle call 

request responses and state reports. */ 
interface IpAppCall : IpOsa { 

/* This method indicates that the request to route the call to the 

destination was successful . ^^7 
void routeRes ( 

in TpSessionID callSessionID, 
in TpCallReport eventReport, 
in TpSessionID callLegSessionID 
) 
raises (TpGCCSException, TpGeneralException) ; 

/^ This method indicates that the request to route the call to the 

destination party was unsuccessful. */ 
void routeErr ( 

in TpSessionID callSessionID, 

in TpCallError errorlndication, 

in TpSessionID callLegSessionID 

) 
raises (TpGCCSException, TpGeneralException) ; 

/* This method reports all necessary information requested by the 

application, for example to calculate charging.*/ 
void getCallInf oRes ( 

in TpSessionID callSessionID, 
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in TpCallInf oReport callinf oReport 
) 
raises (TpGCCSException, TpGeneralException) ; 

/^ This asynchronous method reports that the original request was erroneous, 

or resulted in an error condition.*/ 
void getCallInf oErr ( 

in TpSessionID callSessionID, 

in TpCallError errorlndication 

) 
raises (TpGCCSException, TpGeneralException) ; 

/* This asynchronous method reports a call supervision event to the application.*/ 
void superviseCallRes ( 

in TpSessionID callSessionID, 

in TpCallSuperviseReport report, 

in TpDuration usedTime 
) 

raises (TpGCCSException, TpGeneralException) ; 

/* This asynchronous method reports a call supervision error to the application.*/ 
void superviseCallErr ( 

in TpSessionID callSessionID, 

in TpCallError errorlndication 

) 
raises (TpGCCSException, TpGeneralException) ; 

/* This method indicates to the application that a fault in the network has 

been detected.*/ 
void callFaultDetected ( 

in TpSessionID callSessionID, 

in TpCallFault fault 

) 
raises (TpGCCSException, TpGeneralException) ; 

void callEnded ( 

in TpSessionID callSessionID, 
in TpCallEndedReport report 
) 
raises (TpGCCSException, TpGeneralException) ; 



}; // end module gcc 
}; // end module cc 
}; // end module osa 
}; // end module threegpp 
}; // end module org 

#endif 

// END file GCC.idl 



9.3.3 Enhanced Call Control IDL 

The IDL in this section is only suppHed in order to make the User Interaction IDL compile. 

With the createUICallO method on the UIManager object it is possible to associate the UlCall object to a Call object as 
well as a CallLeg object. The CallLeg object is not used in this specification. However the IDL for this interface has to 
be supplied otherwise the User Interaction IDL will not compile. 

// source file: ECC. idl 

#ifndef OSA_CC_ECC_DEFINED 

#define OSA_CC_ECC_DEFINED 

#include <GCC.idl> 

module org { 
module threegpp { 
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module osa { 
module cc { 
module ecc { 



typedef Tplnt32 TpMediaType; 

const Tplnt32 P_AUDIO = 1; 
const Tplnt32 P_VIDEO = 2; 
const Tplnt32 P_DATA = 4; 

typedef Tplnt32 TpAudioCapabilitiesType; 

typedef Tplnt32 TpVideoCapabilitiesType; 

typedef Tplnt32 TpDataCapabilities; 

union TpChannelDataTypeRequest switch (TpMediaType) { 

case P_DATA: TpDataCapabilities Data; 

case P_VIDEO: TpVideoCapabilitiesType Video; 

case P_AUDIO: TpAudioCapabilitiesType Audio; 

}; 

typedef TpChannelDataTypeRequest TpChannelDataType; 



enum TpChannelDirection { 

P_INCOMING, 

P_OUTGOING 



struct TpChannelRequest { 

TpChannelDataTypeRequest DataTypeRequest ; 
TpChannelDirection Direction; 



typedef sequence <TpChannelRequest> TpChannelRequestSet ; 

enum TpCallLegType { 

P_CALL_LEG_TYPE_UNDEFINED, 

P_CALL_LEG_TYPE_CONTROLLING, 

P_CALL_LEG_TYPE_PASSIVE 

}; 

enum TpCallLegInf oType { 

P_CALL_LEG_INFO_UNDEF INED , 
P_CALL_LEG_INFO_ADDRESS, 
P_CALL_LEG_INFO_RELEASE_CAUSE , 
P_CALL_LEG_INFO_APPINFO, 
P_CALL_LEG_INFO_TIMES 

}; 

interface IpMMChannel : IpService { 

void close ( 

in TpSessionID channelSessionID 

) 
raises (TpGeneralException, TpGCCSException) ; 

In- 



struct TpChannel { 
TpChannelDirection Direction; 
IpMMChannel Channel; 
TpChannelDataType DataType; 
Tplnt32 ChannelNumber; 

}; 

typedef sequence <TpChannel> TpChannelSet ; 



interface IpCallLeg : IpService { 
void routeCallLegToOrigination ( 

in TpSessionID callLegSessionID, 

in TpAddress targetAddress, 

in TpAddress originatingAddress, 
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in TpAddress originalCalledAddress, 
in TpAddress redirectingAddress, 
in TpCallAppInf oSet applnfo 
) 
raises (TpGeneralException, TpGCCSException) ; 

void routeCallLegToDestination ( 

in TpSessionID callLegSessionID, 

in TpAddress targetAddress, 

in TpAddress originatingAddress, 

in TpAddress originalCalledAddress, 

in TpAddress redirectingAddress, 

in TpCallAppInf oSet applnfo 

) 
raises (TpGeneralException, TpGCCSException) ; 

void eventReportReq ( 

in TpSessionID callLegSessionID, 

in TpCallReportRequestSet eventReportsRequested 

) 
raises (TpGeneralException, TpGCCSException) ; 

void release ( 

in TpSessionID callLegSessionID, 

in TpCallReleaseCause cause 

) 
raises (TpGeneralException, TpGCCSException) ; 

void getlnfoReq ( 

in TpSessionID callLegSessionID, 

in TpCallLegInf oType callLegInf oRequested 

) 
raises (TpGeneralException, TpGCCSException) ; 

void getType ( 

in TpSessionID callLegSessionID, 

out TpCallLegType callLegType 

) 
raises (TpGeneralException, TpGCCSException) ; 

void getCall ( 

in TpSessionID callLegSessionID, 

out org: rthreegpp :: osa :: CO :: gcc :: TpCallldentifier callRef erence 

) 
raises (TpGeneralException, TpGCCSException) ; 

void mediaChannelAllow ( 

in TpSessionID callLegSessionID, 

in TpSessionlDSet channelList 

) 
raises (TpGeneralException, TpGCCSException) ; 

void getMediaChannels ( 

in TpSessionID callLegSessionID, 

out TpChannelSet channels 

) 
raises (TpGeneralException, TpGCCSException) ; 

void mediaChannelMonitorReq ( 

in TpSessionID callLegSessionID, 

in TpChannelRequestSet channelEventCriteria, 

in TpCallMonitorMode monitorMode 

) 
raises (TpGeneralException, TpGCCSException) ; 

}; 

struct TpCallLegldentif ier { 
TpSessionID CallLegSessionID; 
IpCallLeg CallLegRef erence; 



}; // end module ecc 
}; // end module cc 
}; // end module osa 
}; // end module threegpp 
}; // end module org 
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#endif 

// END file ECC.idl 



9.4 



User Interaction IDL 



9.4.1 Common data types for User Interaction 



// source file: Ul.idl 

// User Interaction data description 



#ifndef 
#def ine 



_OSA_UI_DEFINED 
_OSA_UI_DEFINED 



#include <OSA.idl> 



module org { 
module threegpp { 
module osa { 
module ui { 

/* Defines the additional properties for the collection of information */ 

struct TpUICollectCriteria { 
Tplnt32 MinLength; /^ minimum number of characters to collect '^ / 

Tplnt32 MaxLength; /^ maxmum number of characters to collect */ 

TpString EndSequence; /* character (s) which terminate an input of variable length. */ 
TpDuration StartTimeout ; / '^ defines a duration (in seconds) */ 
TpDuration InterCharTimeout ; / '^ value for the inter-character time-out timer. ^/ 

}; 

/* Defines the UI call error codes. '^ / 

enum TpUIError { 
P_UI_ERROR_UNDEFINED, /^ Undefined error ^/ 

P_UI_ERROR_ILLEGAL_ID, /^ The information id specified is invalid ^/ 

P_UI_ERROR_ID_NOT_FOUND, /* Information id is not known to the the User Interaction SCFs */ 
P_UI_ERROR_RESOURCE_UNAVAILABLE, /^ Resources used by the User Interaction SCFs are unavailable. 



V 



/* The values for manimum and maximum collection length are out of 



P_UI_ERROR_ILLEGAL_RANGE, 

range '^ / 

P_UI_ERROR_IMPROPER_CALLER_RESPONSE, /^ Improper user response ^/ 

P_UI_ERROR_ABANDON, /* Specified leg is disconnected before the send information 

completed */ 

P_UI_ERROR_NO_OPERATION_ACTIVE, /* No active user interaction for the specified leg. */ 

P_UI_ERROR_NO_SPACE_AVAILABLE /^ There is no more storage capacity to record the message.*/ 



/* Defines the type of the dataString parameter in the method userlnteractionEventNotify '^ / 
enum TpUIEventInf oDataType { 
P_UI_EVENT_DATA_TYPE_UNDEFINED, /* Undefined */ 
P_UI_EVENT_DATA_TYPE_UNSPECIFIED, /* Unspecified data */ 
P_UI_EVENT_DATA_TYPE_TEXT, /* Text */ 

P_UI_EVENT_DATA_TYPE_USSD_DATA /* USSD data starting with coding scheme */ 

}; 

/* Defines the Sequence of Data Elements that specify the additional criteria for receiving a UI 
notification */ 
struct TpUIEventCriteria { 
TpAddressRange OriginatingAddress; /* Address of the end-user for which notification shall be 
handled '^ / 

TpAddressRange DestinationAddress; 
TpString ServiceCode; /* 2 digit code indicating the UI to be triggered. */ 

}; 

/* Defines the Sequence of Data Elements that specify a UI notification */ 
struct TpUIEventlnfo { 

TpAddress OriginatingAddress; /* Address of the end-user for which notification shall be handled 

V 

TpAddress DestinationAddress; 
TpString ServiceCode; /* 2 digit code indicating the UI to be triggered. */ 
TpUIEventInf oDataType DataType Indication; 
TpString DataString; 

}; 
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/^ Defines the cause of the UI fault detected. */ 
enum TpUIFault { 

P_UI_FAULT_UNDEFINED, /^ Undefined */ 

P_UI_CALL_DEAS SIGNED /^ The related Call object has been deassigned. */ 

}; 

/* Defines the type of information send to the end-user */ 
enum TpUIInfoType { 

P_UI_INFO_ID, /* The information consists of an ID ^/ 

P_UI_INFO_DATA, /* The information consists of a data string */ 

P_UI_INFO_AD DRESS /* The information consists of a URL. */ 

}; 

/* Defines the Tagged Choice of Data Elements that specifies the information to be send to a end- 
user. */ 

union TpUIInfo switch (TpUIInfoType) { 
case P_UI_INFO_ID: Tplnt32 InfoID; /^Defines the ID of the user information script or 

stream to send to an end-user.*/ 

case P_UI_INFO_DATA: TpString InfoData; /^Defines the data to be sent to an end-user's terminal.*/ 
case P_UI_INFO_ADDRESS: TpURL InfoAddress; /^Defines the URL of the text or stream to be sent to 
an end-user's terminal"^/ 

}; 

/* Defines the criteria for recording of messages '^ / 

struct TpUIMessageCriteria { 

TpString EndSequence; / '^ Defines the character (s) which terminate an input of variable length. 

V 
TpDuration MaxMessageTime; /* Specifies the maximum allowed duration in seconds. */ 
Tplnt32 MaxMessageSize; /* Specifies the maximum allowed size in bytes of the message. */ 

}; 

/* Defines the UI call reports if a response was requested. */ 

enum TpUIReport { 
P_UI_REPORT_UNDEFINED, /* Undefined report */ 

P_UI_REPORT_ANNOUNCEMENT_ENDED, /* Confirmation that the announcement has ended */ 
P_UI_REPORT_LEGAL_INPUT, /* Information collected., meeting the specified criteria. */ 
P_UI_REPORT_NO_INPUT, /* User immediately entered the delimiter character. No valid information 
has been returned '^ / 

P_UI_REPORT_TIMEOUT, /* User did not input any response before the input timeout 

expired '^ / 

P_UI_REPORT_MESSAGE_STORED, /* A message has been stored successfully */ 
P_UI_REPORT_MESSAGE_NOT_STORED /* The message has not been stored successfully */ 

}; 

/* Defines the situations for which a response is expected following the user interaction. */ 
const Tplnt32 P_UI_RESPONSE_REQUIRED =1; /* A response must be sent when the request has 

completed. '^ / 
const Tplnt32 P_UI_LAST_ANNOUNCEMENT_IN_A_ROW = 2; /* This is the final announcement within a 

sequence. '^ / 
const Tplnt32 P_UI_FINAL_REQUEST = 4; /* This is the final request. */ 

typedef Tplnt32 TpUIResponseRequest ; /* Defines the situations for which a response is expected 
following the user interaction. */ 

/* Defines the type of the variable parts in the information to send to the user. */ 
enum TpUIVariablePartType { 

P_UI_VARIABLE_PART_INT, /* Variable part is of type integer */ 

P_UI_VARIABLE_PART_ADDRESS, /* Variable part is of type address */ 

P_UI_VARIABLE_PART_TIME, /* Variable part is of type time */ 

P_UI_VARIABLE_PART_DATE, /* Variable part is of type date */ 

P_UI_VARIABLE_PART_PRICE /* Variable part is of type price */ 



/* Defines the Tagged Choice of Data Elements that specify the variable parts in the information to 

send to the user. */ 
union TpUIVariableInf o switch (TpUIVariablePartType) { 

case P_UI_VARIABLE_PART_INT: Tplnt32 VariablePart Integer; 

case P_UI_VARIABLE_PART_ADDRESS: TpString VariablePartAddress; 

case P_UI_VARIABLE_PART_TIME: TpTime VariablePartTime; 

case P_UI_VARIABLE_PART_DATE: TpDate VariablePartDate; 

case P_UI_VARIABLE_PART_PRICE: TpPrice VariablePartPrice; 

}; 

/* Defines a Numbered Set of Data Elements of TpUIVariableInf o . */ 
typedef sequence <TpUIVariableInf o> TpUIVariableInf oSet; 
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/^ Define the possible Exceptions. */ 
exception TpGUISException { 
Tplnt32 exceptionType; 

}; 



/* Invalid criteria specified '^ / 
Information id specified is invalid */ 
/^ Information id is not known to the User 



const Tplnt32 P_GUIS_INVALID_CRITERIA = 7 68; 

const Tplnt32 P_GUIS_ILLEGAL_ID = 769; /^ 

const Tplnt32 P_GUIS_ID_NOT_FOUND = 770; 

Interaction Service '^ / 
const Tplnt32 P_GUIS_ILLEGAL_RANGE = 771; 

collection length are out of range '^ / 
const Tplnt32 P_GUIS_INVALID_COLLECTION_CRITERIA = 772; /^ 
const Tplnt32 P_GUIS_INVALID_NETWORK_STATE = 774; /^ 

allowed by the gateway, the underlying protocol can not support it. */ 
const Tplnt32 P_GUIS_UNEXPECTED_SEQUENCE = 775; /* Although the sequence of method calls is 

allowed by the gateway, the underlying protocol can not support it. '^ / 



/* The values for minimum and maximum 



Invalid collection criteria specified '*' / 
Although the sequence of method calls is 



}; // end module ui 
}; // end module osa 
}; // end module threegpp 
}; // end module org 

#endif 

// END file Ul.idl 



9.4.2 Generic User Interaction IDL 

// source file: GUI.idl 

// GUIS Interface description 



#ifndef 
#def ine 



_OSA_UI_GUI_DEFINED 
_OSA_UI_GUI_DEFINED 



#include <UI.idl> 
#include <ECC.idl> 

module org { 
module threegpp { 
module osa { 
module ui { 
module gui { 

interface IpAppUIManager; // forward definition; 
interface IpAppUI; // forward definition; 
interface IpAppUICall; // forward definition; 

/^ The Generic User Interaction SCF Interface provides functions to send 

information to, or gather information from the user. */ 
interface IpUI : IpService { 

/* This method plays an announcement or sends other information to the user.*/ 
void sendlnfoReq ( 

in TpSessionID userlnteractionSessionID, 
in TpUIInfo info, 

in TpUIVariableInf oSet variableinf o, 
in Tplnt32 repeatlndicator, 
in TpUIResponseRequest responseRequested, 
out TpAssignmentID assignmentID 
) 
raises (TpGUISException, TpGeneralException) ; 

/* This method plays an announcement or sends other information to the user 

and collects some information from the user. */ 
void sendinf oAndCollectReq ( 

in TpSessionID userlnteractionSessionID, 

in TpUIInfo info, 

in TpUIVariableInf oSet variableinf o, 

in TpUICollectCriteria criteria, 

in TpUIResponseRequest responseRequested, 

out TpAssignmentID assignmentID 
) 
raises (TpGUISException, TpGeneralException) ; 

/* This method requests that the relationship between the application and 

the user interaction object be released. */ 
void release ( 
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in TpSessionID userlnteractionSessionID 
) 
raises (TpGUISException, TpGeneralException) ; 

}; 

/* Defines the Sequence of Data Elements that unambiguously specify the UI object '^ / 
struct TpUIIdentifier { 

TpSessionID UserlnteractionSessionID; 

IpUI UIRef; 



/^ The Call User Interaction Service Interface provides functions to send 

information to, or gather information from, the user. */ 
interface IpUICall : IpUI { 

/^ This asynchronous method aborts the specified user interaction operation. */ 
void abortActionReq ( 

in TpSessionID userlnteractionSessionID, 
in TpAssignmentID assignmentID 
) 

raises (TpGUISException, TpGeneralException) ; 
}; 

/* Defines the Sequence of Data Elements that unambiguously specify the UlCall object. '^ / 
struct TpUICallldentifier { 

IpUICall UICallRef; 

TpSessionID UserlnteractionSessionID; 
}; 

/* This interface is the ' SCF manager' interface for the Generic User Interaction SCF . */ 
interface IpUIManager : IpService { 

/* This method is used to create a new user interaction object for non-call related purposes */ 
void createUI ( 

in IpAppUI appUI, 
in TpAddress userAddress, 
out TpUIIdentifier userlnteraction 
) 
raises (TpGUISException, TpGeneralException) ; 

/^ This method is used to create a new user interaction object for call related purposes. */ 
void createUICall ( 

in IpAppUICall appUI, 

in org: rthreegpp: :osa: '.co.'. :gcc: : TpCallldentif ier callldentif ier, 

in org: rthreegpp: :osa: '.co.'. :ecc: : TpCallLegldentif ier callLegldentif ier, 

out TpUICallldentifier userlnteraction 
) 
raises (TpGUISException, TpGeneralException) ; 

/^ This method is used to enable the reception of user initiated user interaction. */ 
void enableUINotif ication ( 

in IpAppUIManager applnterf ace, 

in TpUIEventCriteria eventCriteria, 

out TpAssignmentID assignmentID 
) 
raises (TpGUISException, TpGeneralException) ; 

/^ This method is used by the application to disable UI notifications. '^ / 
void disableUINotif ication ( 

in TpAssignmentID assignmentID 
) 
raises (TpGUISException, TpGeneralException) ; 



/* The Generic User Interaction SCF manager application interface provides 

the application call management functions to the Generic User Interaction SCF. ^/ 
interface IpAppUIManager : IpOsa { 

/* This method indicates to the application that the User Interaction SCF 

instance has terminated or closed abnormally. '^ / 
void userlnteractionAborted ( 

in TpUIIdentifier userlnteraction 
) 
raises (TpGUISException, TpGeneralException) ; 

/* This method notifies the application of an user initiated request for user interaction. */ 
void userlnteractionEventNotify ( 
in TpUIIdentifier ui. 
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in TpUIEventInf o eventlnfo, 

in TpAssignmentID assignmentID, 

out IpAppUI applnterface 
) 
raises (TpGUISException, TpGeneralException) ; 

void userlnteractionNotif icationlnterrupted () 
raises (TpGUISException, TpGeneralException) ; 

void userlnteractionNotif icationContinued () 
raises (TpGUISException, TpGeneralException) ; 

}; 

/* The User Interaction Application Interface is used to handle generic user 

interaction request responses and reports. */ 
interface IpAppUI : IpOsa { 

/^ This method informs the application about the start or the completion of a sendinf oCallReq ( ) . 

V 
void sendlnfoRes ( 

in TpSessionID userlnteractionSessionID, 
in TpAssignmentID assignmentID, 
in TpUIReport response 
) 
raises (TpGUISException, TpGeneralException) ; 

/* This asynchronous method indicates that the request to send information was unsuccessful. */ 
void sendlnfoErr ( 

in TpSessionID userlnteractionSessionID, 

in TpAssignmentID assignmentID, 

in TpUIError error 
) 
raises (TpGUISException, TpGeneralException) ; 

/^ This asynchronous method returns the information collected to the application. */ 
void sendinf oAndCollectRes ( 

in TpSessionID userlnteractionSessionID, 

in TpAssignmentID assignmentID, 

in TpUIReport response, 

in TpString info 
) 
raises (TpGUISException, TpGeneralException) ; 

/^ This asynchronous method indicates that the request to send information 

and collect a response was unsuccessful. */ 
void sendinf oAndCollectErr ( 

in TpSessionID userlnteractionSessionID, 

in TpAssignmentID assignmentID, 

in TpUIError error 
) 
raises (TpGUISException, TpGeneralException) ; 

/* This method indicates to the application that a fault has been detected in the user 

interaction. ^/ 
void userlnteractionFaultDetected ( 

in TpSessionID userlnteractionSessionID, 

in TpUIFault fault 
) 
raises (TpGUISException, TpGeneralException) ; 



/* The Call User Interaction Application Interface is used to handle call user 

interaction request responses and reports. */ 
interface IpAppUICall : IpAppUI { 

/^ This method confirms that the request to abort a user interaction operation on a call was 

successful. */ 
void abortActionRes ( 

in TpSessionID userlnteractionSessionID, 
in TpAssignmentID assignmentID 
) 
raises (TpGUISException, TpGeneralException) ; 

/^ This asynchronous method indicates that the request to abort a user interaction 

operation on a call resulted in an error. ^/ 
void abortActionErr ( 

in TpSessionID userlnteractionSessionID, 

in TpAssignmentID assignmentID, 
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in TpUIError error 
) 
raises (TpGUISException, TpGeneralException) ; 



}; // end module gui 
}; // end module ui 
}; // end module osa 
}; // end module threegpp 
}; // end module org 



#endif 

// END file GUI.idl 
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9.5 



Data Session Control 



// OSA data session control 



#ifndef OSA_DSC_DEFINED 

#define OSA_DSC_DEFINED 



#include "osa.idl" 



module org 
{ 

module threegpp 

{ 

module osa 



// data session control 

module dsc 

{ 



interface IpDataSessionControlManager; // forward definition 

interface IpDataSession; // forward definition 

interface IpAppDataSessionControlManager; // forward definition 

interface IpAppDataSession; // forward definition 



const Tplnt32 P_EVENT_NAME_UNDEFINED = 0; 
const Tplnt32 P_EVENT_DSCS_ESTABLISHED_ = 1; 



// Undefined 

// Data Session established 



typedef Tplnt32 TpDataSessionEventName; /^Defines the names of event being notified. '^ / 

enum TpDataSessionChargeOrderCategory 
{ 

P_DATA_SESSION_CHARGE_PER_VOLUME, 

P_D AT A_S E S S I ON_CHARGE_NE T WORK 



struct TpChargePerVolume 
{ 

Tplnt32 InitialCharge; 

Tplnt32 Cur rent ChargePerKilobyte; 

Tplnt32 NextChargePerKilobyte; 
}; 

union TpDataSessionChargeOrder switch (TpDataSessionChargeOrderCategory) 
{ 

case P_DATA_SESSION_CHARGE_PER_VOLUME: TpChargePerVolume ChargePerVolume; 

case P_DATA_SESSION_CHARGE_NETWORK: TpString NetworkCharge; 
In- 
struct TpDataSessionChargePlan 
{ 

TpDataSessionChargeOrder Char geOrder Type; 

TpString Currency; 

TpString Additionalinf o; 



struct TpDataSessionEvent Criteria 

{ 

TpAddressRange DestinationAddress; /^Destination address range*/ 
TpAddressRange OriginationAddress; /^Origination address range */ 
TpDataSessionEventName DataSessionEventName; /^Name of the event (s) '^ / 



}; 



/* Defines the mode that the data session will monitor for events, or the mode that the 
data session is in following a detected event. */ 
enum TpDataSessionMonitorMode 
{ 

P_DATA_SESSION_MONITOR_MODE_INTERRUPT, /* The data session event is intercepted by 
the data session control SCF and data session establishment is interrupted. The application 
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is notified of the event and data session establishment resumes following an appropriate API 
call or network event (such as a data session release) '^ / 

P_DATA_SESSION_MONITOR_MODE_NOTIFY, /^ The data session event is detected by the 
data session control SCF but not intercepted. The application is notified of the event data 
session establishment continues '^ / 

P_DATA_SESSION_MONITOR_MODE_DO_NOT_MONITOR /^ Do not monitor for the event ^/ 
In- 
struct TpDataSessionEventInf o 
{ 

TpAddress DestinationAddress; 
TpAddress OriginatingAddress; 

TpDataSessionEventName DataSessionEventName; 
TpDataSessionMonitorMode MonitorMode; 

}; 

/* Defines the Sequence of Data Elements that specify the cause of the release of a 
call.^/ 

struct TpDataSessionReleaseCause 
{ 

Tplnt32 Value; 
Tplnt32 Location; 

}; 

/* Defines a specific data session error. */ 

enum TpDataSessionErrorType 
{ 

P_DATA_SESSION_ERROR_UNDE FINED, /^ Undefined ^/ 

P_DATA_SESSION_ERROR_INVALID_ADDRESS, /^ The operation failed because an invalid 
address was given ^/ 

P_DATA_SESSION_ERROR_INVALID_STATE /^ The data session was not in a valid state for 
the requested operation ^/ 

}; 

/* Defines the Tagged Choice of Data Elements that specify additional data session error 
and data session error specific information. */ 

union TpDataSessionAdditionalErrorInf o switch (TpDataSessionErrorType) 
{ 

case P_DATA_SESSION_ERROR_INVALID_ADDRESS: TpAddressError 
DataSessionErrorlnvalidAddress; 

}; 

/* Defines the Sequence of Data Elements that specify the additional information 
relating to an undefined data session error. ^/ 
struct TpDataSessionError 
{ 

TpDataSessionAdditionalErrorInf o AdditionalErrorInf o; 

TpDataSessionErrorType Err or Type; 

TpDateAndTime ErrorTime; 

}; 

/* Defines the cause of the Data Session fault detected. */ 
enum TpDataSessionFault 
{ 

P_DATA_SESSION_FAULT_UNDEFINED, /^ Undefined ^/ 

P_DATA_SESSION_FAULT_USER_ABORTED, /^ User has finalised the data session before any 
message could be sent by the application. ^/ 

P_DATA_SESSION_TIMEOUT_ON_RELEASE, /^ Final report has been sent to the application, 
but the application did not explicitly release data session object, within a specified time. 
V 

P_DATA_SESSION_TIMEOUT_ON_INTERRUPT /^ Application did not instruct the gateway how to 
handle the data session within a specified time, after the gateway reported an event that was 
requested by the application in interrupt mode.*/ 



/* Defines a specific data session event report type. */ 

enum TpDataSessionReportType 

{ 

P_DATA_SESSION_REPORT_UNDEFINED, /* Undefined */ 

P_DATA_SESSION_REPORT_CONNECTED, /* Data session established*/ 

P_DATA_SESSION_REPORT_DISCONNECT /* data session disconnect requested by data 
session party */ 

}; 

/* Defines the Tagged Choice of Data Elements that specify additional data session report 
information. */ 

union TpDataSessionAdditionalReportInf o switch (TpDataSessionReportType) 
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case P_DATA_SESSION_REPORT_DISCONNECT: TpDataSessionReleaseCause DataSessionDisconnect; 
In- 
struct TpDataSessionReport 
{ 

TpDataSessionMonitorMode MonitorMode; 

TpDateAndTime DataSessionEventTime; 

TpDataSessionReport Type DataSessionReportType; 

TpDataSessionAdditionalReportInf o AdditionalReportInf o; 

}; 

/^ Defines the Sequence of Data Elements that specify the criteria relating to Data 
Session report requests. */ 

struct TpDataSessionReport Request 
{ 

TpDataSessionMonitorMode MonitorMode; 

TpDataSessionReport Type DataSessionReportType; 
}; 

/^ Defines a Numbered Set of Data Elements of TpDataSessionReportRequest . '^ / 
typedef sequence <TpDataSessionReportRequest> TpDataSessionReportRequestSet ; 

const Tplnt32 P_DATA_SESSION_SUPERVISE_VOLUME_REACHED = 1; /^ The Data Session 
supervision volume has been reached. '^ / 

const Tplnt32 P_DATA_SESSION_SUPERVISE_DATA_SESSION_ENDED =2; /^ The data session has 
ended, either due to reach of maximum volume or calling or called party release. */ 

const Tplnt32 P_DATA_SESSION_SUPERVISE_MESSAGE_SENT =4; /^ A warning message has been 
sent. '^ / 

/* Defines the responses from the data session control SCF for data sessions that are 
supervised: */ 

typedef Tplnt32 TpDataSessionSuperviseReport ; 

const Tplnt32 P_DATA_SESSION_SUPERVISE_RELEASE = 1; /* Release the Data Session when 
the Data Session supervision volume has been reached. */ 

const Tplnt32 P_DATA_SESSION_SUPERVISE_RESPOND =2; /^ Notify the application when the 
data session supervision volume has been reached. '^ / 

const Tplnt32 P_DATA_SESSION_SUPERVISE_INFORM =4; /^ Send a warning message to the 
originating party when the maximum volume is reached. If data session release is requested, 
then the data session will be released following the message after an administered time 
period */ 

/* Defines the following treatment of the data session by the data session control SCF when 
the maximum volume has been reached. "^7 

typedef Tplnt32 TpDataSessionSuperviseTreatment ; 

/^ Defines the Sequence of Data Elements that specify the amount of volume that is allowed 
to be transmitted for the specific connection. ^/ 

struct TpDataSessionSuperviseVolume { 

Tplnt32 VolumeQuantity; /* Qantity of the granted volume that can be transmitted for the 
specific connection. */ 

Tplnt32 VolumeUnit; / '^ Unit of the granted volume that can be transmitted for the 
specific connection. */ 

}; 

/* Define the possible Exceptions. '^ / 

const Tplnt32 P_DSCS_SERVICE_INFORMATION_MISSING = 1024; 

const Tplnt32 P_DSCS_SERVICE_FAULT_ENCOUNTERED = 1025; 

const Tplnt32 P_DSCS_UNEXPECTED_SEQUENCE = 102 6; 

const Tplnt32 P_DSCS_INVALID_ADDDRESS = 1027; 

const Tplnt32 P_DSCS_INVALID_STATE = 1028; 

const Tplnt32 P_DSCS_INVALID_CRITERIA = 1029; 

const Tplnt32 P_DSCS_INVALID_NETWORK_STATE = 1030; 

exception TpDSCSException 
{ 

Tplnt32 exceptionType; 

}; 

/* Sequence of Data Elements that unambiguously specify the Data Session object */ 

struct TpDataSessionldentif ier 

{ 

IpDataSession DataSessionRef erence; 

TpSessionID DataSessionSessionID; 

}; 
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/* This interface is the SCF manager' interface for Data Session Control. '^ / 

interface IpDataSessionControlManager : IpService 

{ 

/^ This method is used to enable data session notifications. '^ / 

void enableDataSessionNotif ication ( 

in IpAppDataSessionControlManager applnterf ace, 

in TpDataSessionEventCriteria eventCriteria, 

out TpAssignmentID assignmentID) 

raises (TpDSCSException, TpGeneralException) ; 

/* This method is used by the application to disable data session notifications . ^^7 
void disableDataSessionNot if ication 
( 

in TpAssignmentID assignmentID) 

raises (TpDSCSException, TpGeneralException) ; 

}; 

/* This interface provides the means to control a data session. */ 

interface IpDataSession : IpService 

{ 

/* This method requests connection of the data session to the destination party.*/ 

void connectReq ( 

in TpSessionID dataSessionID, 

in TpDataSessionReportRequestSet responseRequested, 

in TpAddress targetAddress, 

in TpAddress originatingAddress, 

out TpAssignmentID assignmentID) 

raises (TpDSCSException, TpGeneralException) ; 

/* This method requests the release of the data session and associated objects.*/ 
void release ( 

in TpSessionID dataSessionID, 

in TpDataSessionReleaseCause cause) 

raises (TpDSCSException, TpGeneralException) ; 

/* The application calls this method to supervise a data session. */ 
void superviseDataSessionReq ( 

in TpSessionID dataSessionID, 

in TpDataSessionSuperviseTreatment treatment, 

in TpDataSessionSuperviseVolume bytes) 

raises (TpDSCSException, TpGeneralException) ; 

/* The application calls this method to set the charge plan */ 
void setDataSessionChargePlan ( 

in TpSessionID dataSessionID, 

in TpDataSessionChargePlan dataSessionChargePlan) 

raises (TpDSCSException, TpGeneralException) ; 

/* The application calls this method to send advice of charge information */ 
void setAdviceOfCharge ( 

in TpSessionID dataSessionID, 

in TpAoCInfo aoCInfo, 

in TpDuration tariff Switch) 

raises (TpDSCSException, TpGeneralException) ; 

}; 



/* The data session control manager application interface provides the 

application data session control management functions to the data session control 

SCF. */ 

interface IpAppDataSessionControlManager : IpOsa 

{ 

void dataSessionAborted ( 

in TpSessionID dataSessionRef erence) 

raises (TpDSCSException, TpGeneralException) ; 

/* This method notifies the application of the arrival of a data session-related event. 



*/ 



void dataSessionEventNotify ( 

in TpDataSessionldentif ier dataSessionRef erence, 
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in TpDataSessionEventInf o eventlnfo, 

in TpAssignmentID assignmentID, 

out IpAppDataSession applnterf ace) 

raises (TpDSCSException, TpGeneralException) ; 

/^ This method indicates to the application that all event notifications 

are resumed. */ 

void dataSessionNotif icationContinued () 

raises (TpDSCSException, TpGeneralException) ; 

/* This method indicates to the application that all event notifications 

are temporarely iterrupted. ^^7 

void dataSessionNotif icationlnterrupted ( ) 

raises (TpDSCSException, TpGeneralException) ; 



/* The application side of the data session interface is used to handle data session 
request responses and state reports. '^ / 
interface IpAppDataSession : IpOsa 
{ 

/* This method indicates that the request to route the data session to the 
destination was successful . ^^7 
void connectRes ( 

in TpSessionID dataSessionSessionID, 

in TpDataSessionReport eventReport, 

in TpAssignmentID assignmentID) 

raises (TpDSCSException, TpGeneralException) ; 

/* This method indicates that the request to connect the data session to the 
destination party was unsuccessful. '^ / 
void connectErr ( 

in TpSessionID dataSessionSessionID, 

in TpDataSessionError errorlndication, 

in TpAssignmentID assignmentID) 

raises (TpDSCSException, TpGeneralException) ; 

/* This asynchronous method reports a data session supervision event to the 
application. */ 

void superviseDataSessionRes ( 

in TpSessionID dataSessionSessionID, 

in TpDataSessionSuperviseReport report, 

in TpDataSessionSuperviseVolume usedVolume) 

raises (TpDSCSException, TpGeneralException) ; 

/* This asynchronous method reports a data session supervision error to the 
application. */ 

void superviseDataSessionErr ( 

in TpSessionID dataSessionSessionID, 

in TpDataSessionError errorlndication) 

raises (TpDSCSException, TpGeneralException) ; 

/* This method indicates to the application that a fault in the network has 

been detected. ^^7 

void dataSessionFaultDetected ( 

in TpSessionID dataSessionSessionID, 

in TpDataSessionFault fault) 

raises (TpDSCSException, TpGeneralException) ; 



}; // end module dsc 

/////////////////////////////////////////////////////////////////////////////// 
/////////////////////////////////////////////////////////////////////////////// 



}; // osa 
// threegpp 



#endif 



ETS\ 



3G TS 29.1 98 version 3.0.0 Release 1 999 1 73 ETSI TS 1 29 1 98 V3.0.0 (2000-06) 

9.6 Network User Location and User Status IDL 

9.6.1 Common definitions for Network User Location and User Status: 
MM.idI 

#include <OSA.idl> 

module org { 
module threegpp { 
module osa { 
module mm { 

// Defines the type of uncertainty shape, 
enum TpLocationUncertaintyShape { 

P_M_SHAPE_NONE, // No uncertainty shape present. 
P_M_SHAPE_CIRCLE, // Uncertainty shape is a circle. 

P_M_SHAPEa_CIRCLE_SECTOR, // Uncertainty shape is a circle sector. 
P_M_SHAPE_CIRCLE_ARC_STRIPE, // Uncertainty shape is a circle arc stripe. 
P_M_S HAP E_ELL IPSE, // Uncertainty shape is an ellipse. 

P_M_SHAPE_ELLIPSE_SECTOR, // Uncertainty shape is an ellipse sector. 
P_M_SHAPE_ELLIPSE_ARC_STRIPE // Uncertainty shape is an ellipse arc stripe. 

}; 

// Defines the structure of data elements that specify a geographical position. 
// An '''ellipsoid point with uncertainty shape'' defines the horizontal location. 
// The reference system chosen for the coding of locations is the World Geodetic 
// System 1984 (WGS 84) . 
struct TpGeographicalPosition { 

TpFloat Longitude; 

TpFloat Latitude; 

TpLocationUncertaintyShape TypeOf Uncertainty Shape; 

TpFloat Uncert ainty Inner SemiMaj or; 

TpFloat Uncert aintyOuter SemiMaj or; 

TpFloat Uncert ainty I nnerSemlMinor; 

TpFloat Uncert aintyOuterSemlMinor; 

Tplnt32 AngleOfSemiMajor; 

Tplnt32 SegmentStartAngle; 

Tplnt32 SegmentEndAngle; 
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// Defines a diagnostic value that is reported in addition to an error by 
// the Network User Location or User Status SCFs . 
enum TpMobilityDiagnostic { 

P_M_NO_INFORMATION, // No diagnostic information present. 

// Valid for all type of errors. 
P_M_APPL_NOT_IN_PRIV_EXCEPT_LST, // Application not in privacy exception list. 

// Valid for 'Unauthorised Application' error. 
P_M_CALL_TO_USER_NOT_SETUP, // Call to user not set-up. Valid for 

// 'Unauthorised Application' error. 
P_M_PRIVACY_OVERRIDE_NOT_APPLIC, // Privacy override not applicable. Valid for 

// 'Unauthorised Application' error. 
P_M_DISALL_BY_LOCAL_REGULAT_REQ, // Disallowed by local regulatory requirements. 

// Valid for 'Unauthorised Application' error. 
P_M_CONGESTION, // Congestion. Valid for 'Position Method 

// Failure' error. 
P_M_INSUFFICIENT_RESOURCES, // Insufficient resources. Valid for 'Position 

// Method Failure' error. 
P_M_INSUFFICIENT_MEAS_DATA, // Insufficient measurement data. Valid for 

// 'Position Method Failure' error. 
P_M_INCONSISTENT_MEAS_DATA, // Inconsistent measurement data. Valid for 

// 'Position Method Failure' error. 
P_M_LOC_PROC_NOT_COMPLETED, // Location procedure not completed. Valid for 

// 'Position Method Failure' error. 
P_M_LOC_PROC_NOT_SUPP_BY_USER, // Location procedure not supported by user. 

// Valid for 'Position Method Failure' error. 
P_M_QOS_NOT_ATTAINABLE // Quality of service not attainable. Valid for 

// 'Position Method Failure' error. 

}; 

// Defines an error that is reported by the Network User Location or User Status SCFs. 
enum TpMobilityError { 

P_M_OK, // No error occurred while processing the request. 

P_M_SYSTEM_FAILURE, // System failure. The request can not be handled because 
// of a general problem in the network user location SCF 
// , the user status SCFor the 
// underlying network. Fatal 
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P_M_UNAUTHORIZED_NETWORK, // Unauthorised network, The requesting network is 

// not authorised to obtain the user's location or 
// status. Non fatal 
P_M_UNAUTHORIZED_APPLICATION, // Unauthorised application. The application is 

// not authorised to obtain the user's location 
// or status. Fatal 
P_M_UNKNOWN_SUBSCRIBER, // Unknown subscriber. The user is unknown, i.e. no 

// such subscription exists. Fatal 
P_M_ABSENT_SUBSCRIBER, // Absent subscriber. The user is currently not 

// reachable. Non fatal 
P_M_POSITION_METHOD_FAILURE // Position method failure. The network user location SCF 

// failed to obtain the user's position. Non fatal 

}; 

// This enumeration is used in requests to stop network user location or user status 
// reports that are 

// sent from a network user location or user status SCFs to an application. 

enum TpMobilityStopScope { 

P_M_ALL_IN_ASSIGNMENT, // The request concerns all users in an assignment. 

P_M_SPECIFIED_USERS // The request concerns only the users that are 

// explicitly specified in a collection. 

}; 

// Defines the structure of data element that specifies a request to stop whole or parts of an 

// assignment. Assignments are used for periodic or triggered reporting of a 

// user locations or statuses. Observe that the parameter 'Users' is optional. 

// If the parameter 'stopScope' is set to P_M_ALL_IN_ASSIGNMENT, the parameter 

// 'stopScope' is undefined. If the parameter stopScope is set to 

// P_M_SPECIFIED_USERS, then the assignment shall be stopped only for the users 

// specified in the 'users' collection. 

struct TpMobilityStopAssignmentData { 

// Identity of the session that shall be stopped. 

TpSessionID Assignmentid; 

// Specify if only a part of the assignment or if whole the assignment 

// shall be stopped. 

TpMobilityStopScope StopScope; 

// Optional parameter describing which users a stop request is 

// addressing when only a part of an assignment is to be stopped. 

TpAddressSet Users; 

}; 
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9.6.2 Network User Location: MMul.idI 

// Data Definitions & Interfaces 
// Network User Location 
/-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k^ 

#include <MM.idl> 

module org { 
module threegpp { 
module osa { 
module mm { 
module ul { 

// Data definitions 

/■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-^ 

// This data type is identical to a TString. It specifies the Cell Global 

// Identification or the Location Area Identification (LAI) . 

// The Cell Global Identification (CGI) is defined as the string of characters 

// in the following format: 

// MCC-MNC-LAC-CI 

// where: 

// MCC Mobile Country Code (three decimal digits) 

// MNC Mobile Network Code (two or three decimal digits) 

// LAC Location area code (four hexadecimal digits) 

// CI Cell Identification (four hexadecimal digits) 

// 

// The Location Area Identification (LAI) is defined as a string of characters 

// in the following format: 

// MCC-MNC-LAC 

// where: 

// MCC Mobile Country Code (three decimal digits) 

// MNC Mobile Network Code (two or three decimal digits) 

// LAC Location area code (four hexadecimal digits) 

// The length of the parameter indicates which format is used. See 3G TS 29.002 for 
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// the detailed coding. 

typedef TpString TpLocationCelllDOrLAI; 

// Defines the structure of data elements that specifies the criteria for a 
// triggered location report to be generated, 
struct TpLocationTriggerCamel { 

TpBoolean UpdatelnsideVlr; // Generate location report when it occurs an 

// location update inside the current VLR area. 
TpBoolean UpdateOutsideVlr; // Generate location report when the user moves 

// to another VLR area. 

}; 

// Defines the structure of data elements that specifies the location of a mobile 
// telephony user. Observe that if the StatusCode is indicating an error , 
// then neither GeographicalPosition, Timestamp, VlrNumber, LocationNumber, 
// CellldOrLai nor their associated presense flags are defined, 
struct TpUserLocationCamel { 

TpAddress UserlD; // The address of the user. 

TpMobilityError StatusCode; // Indicator of error. 

TpBoolean GeographicalPositionPresent ; // Flag indicating if the 

// geographical position is present. 

TpGeographicalPosition GeographicalPosition; // Specification of a position 

// and an area of uncertainty. 

TpBoolean TimestampPresent ; // Flag indicating if the timestamp is present. 

TpDateAndTime Timestamp; // Timestamp indicating when the location information// 
was attained 



TpBoolean 
TpAddress 
TpBoolean 

TpAddress 
TpBoolean 



VlrNumberPresent; // Flag indicating if the VLR number is present. 
VlrNumber; // Current VLR number for the user. 
LocationNumberPresent; // Flag indicating if the location 

// number is present. 

// Current location number. 

// Flag indicating if cell-id or 

// LAI of the user is present. 

// Cell-id or LAI of the user. 



LocationNumber; 
CellldOrLaiPresent; 



TpLocationCelllDOrLAI CellldOrLai; 



}; 



typedef sequence <TpUserLocationCamel> TpUserLocationCamelSet ; 
// Interface definitions 
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interface IpAppUserLocationCamel; // Forward definition 

// Inherits from the generic service capability feature interface. 

// This interface is the SCF manager's interface for Network User Location. 

interface IpUserLocationCamel : IpService { 

// Request for mobile-related location information on one or several wireles users, 
void locationReportReq ( 

in IpAppUserLocationCamel appLocationCamel, 

in TpAddressSet users, 

out TpSessionID assignmentid) 

raises (TpGeneralException) ; 

// Request for periodic mobile location reports on one or several users, 
void periodicLocationReportingStartReq ( 

in IpAppUserLocationCamel appLocationCamel, 

in TpAddressSet users, 

in TpDuration reportinglnterval, 

out TpSessionID assignmentid) 

raises (TpGeneralException) ; 

// This method stops the sending of periodic mobile location reports for 

// one or several users. 

void periodicLocationReportingStop ( 

in TpMobilityStopAssignmentData stopRequest) 
raises (TpGeneralException) ; 

// Request for user location reports, containing mobile related information, 

// when the location is changed (the report is triggered by the location change) . 

void triggeredLocationReportingStartReq ( 

in IpAppUserLocationCamel appLocationCamel, 

in TpAddressSet users, 

in TpLocationTriggerCamel trigger, 

out TpSessionID assignmentid) 

raises (TpGeneralException) ; 

// Request that triggered mobile location reporting should stop, 
void triggeredLocationReportingStop ( 
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in TpMobilityStopAssignmentData stopRequest) 
raises (TpGeneralException) ; 



// Inherits from the generic service capability feature interface. 

// The network user location application interface is implemented by the client 

// application developer and is used to handle location reports that are 

// specific for mobile telephony users. 

interface IpAppUserLocationCamel : IpOsa { 

// Delivery of a mobile location report. The report is containing 
// mobile-related location information for one or several users, 
void locationReportRes ( 

in TpSessionID assignmentid, 

in TpUserLocationCamelSet locations) 
raises (TpGeneralException) ; 

// This method indicates that the location report request has failed, 
void locationReportErr ( 

in TpSessionID assignmentid, 

in TpMobilityError cause, 

in TpMobilityDiagnostic diagnostic) ; 

// Periodic delivery of mobile location reports. The reports are 

// containing mobile-related location information for one or several users. 

void periodicLocationReport ( 

in TpSessionID assignmentid, 

in TpUserLocationCamelSet locations) 
raises (TpGeneralException) ; 

// This method indicates that a requested periodic location report has 
// failed. Note that errors only concerning individual users are reported 
// in the ordinary periodicLocationReport ( ) message, 
void periodicLocationReportErr ( 

in TpSessionID assignmentid, 

in TpMobilityError cause, 

in TpMobilityDiagnostic diagnostic) ; 

// Delivery of a report that is indicating that one or several user's 
// mobile location has changed. 
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void triggeredLocationReport ( 

in TpSessionID assignmentid, 

in TpUserLocationCamel location, 
in TpLocationTriggerCamel criterion) 
raises (TpGeneralException) ; 

// This method indicates that a requested triggered location report has 
// failed. Note that errors only concerning individual users are reported 
// in the ordinary triggeredLocationReport ( ) message, 
void triggeredLocationReportErr ( 

in TpSessionID assignmentid, 

in TpMobilityError cause, 

in TpMobilityDiagnostic diagnostic) ; 



};};};};}; 

9.6.3 User Status: MMus.idI 

// Data Definitions & Interfaces 
// User Status 

#include <MM.idl> 

module org { 
module threegpp { 
module osa { 
module mm { 
module us { 



// 



Data definitions 



// Defines the status of a user, 
enum TpUserStatusIndicator { 

P_US_REACHABLE, // User is reachable 

P_US_NOT_REACHABLE, // User is not reachable 

P_US_BUSY // User is busy (only applicable for interactive user 
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// status request, not when triggers are used) 

}; 

// Defines the structure of data elements that specify the identity 
// and status of a user, 
struct TpUserStatus { 

TpAddress UserlD; // The user address. 

TpMobilityError StatusCode; // Indicator of error. 

TpUserStatusIndicator Status; // The current status of the user. 

}; 

typedef sequence <TpUserStatus> TpUserStatusSet ; 
// Interface definitions 

interface IpAppUserStatus; // Forward definition 

// Inherits from the generic service capability feature interface. 

// The user status interface represents the interface to the user status SCF. 

interface IpUserStatus : IpService { 

// Request for a report on the status of one or several users, 
void statusReportReq ( 

in IpAppUserStatus appStatus, 

in TpAddressSet users, 

out TpSessionID assignmentid) 
raises (TpGeneralException) ; 

// Request for triggered status reports when one or several user's 
// status is changed. The user status SCF will send a report when 
// the status changes, 
void triggeredStatusReportingStartReq ( 

in IpAppUserStatus appStatus, 

in TpAddressSet users, 

out TpSessionID assignmentid) 
raises (TpGeneralException) ; 

// This method stops the sending of status reports for one or several users. 
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void triggeredStatusReportingStop ( 

in TpMobilityStopAssignmentData stopRequest) 
raises (TpGeneralException) ; 



}; 



// Inherits from the base osa interface. 

// The user-status application interface is implemented by the client 
// application developer and is used to handle user status reports, 
interface IpAppUserStatus : IpOsa { 

// Delivery of a report, that is containing one or several user's status, 
void statusReportRes ( 

in TpSessionID assignmentid, 

in TpUserStatusSet status) 

raises (TpGeneralException) ; 

// This method indicates that the status report request has failed, 
void statusReportErr ( 

in TpSessionID assignmentid, 

in TpMobilityError cause, 

in TpMobilityDiagnostic diagnostic) ; 

// Delivery of a report that is indicating that a user's status has changed, 
void triggeredStatusReport ( 

in TpSessionID assignmentid, 

in TpUserStatus status) 

raises (TpGeneralException) ; 

// This method indicates that a requested triggered status reporting has 
// failed. Note that errors only concerning individual users are reported 
// in the ordinary triggeredStatusReport ( ) message, 
void triggeredStatusReportErr ( 

in TpSessionID assignmentid, 

in TpMobilityError cause, 

in TpMobilityDiagnostic diagnostic) ; 

}; 



};};};};}; 
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9.6.4 Terminal Capabilities: TERMCAP.idI 



#ifndef 
#def ine 



_TERMCAP_DEF INED 
_TERMCAP_DEF INED 



#include <OSA.idl> 



module org { 
module threegpp { 
module osa { 
module termcap { 

enum TpTerminalCapabilitiesError 
P_TERMCAP_ERROR_UNDEF INED , 
P_TERMCAP_INVALID_TERMINALID, 
P_TERMCAP_SYSTEM_FAILURE 



/^ Undefined */ 

/* Terminal ID not valid */ 

/ '^ General problem in terminal capabilities SCF or 

in underlying network ^/ 



exception TpTermCapException { 

TpTerminalCapabilitiesError error; 



/* TpTerminalCapabilities : Structure containing status code and terminal 

capabilities. */ 

struct TpTerminalCapabilities { 

/* statusCode: Indicates whether or not the terminalCapabilities 
are available. */ 
TpBoolean StatusCode; 

/* terminalCapabilities: Specifies the latest available capabilities of the user's terminal. 
This information, if available, is returned as CC/PP headers as specified in W3C [12] and 
adopted in the WAP UAProf specification [13] . It contains URLs; terminal attributes and 
values, in RDF format; or a combination of both. ^/ 
TpString TerminalCapabilities; 
}; 

interface TpTerminalCapabilities : IpService { 
/* Method: getTerminalCapabilities ( ) 

This method is used by an application to get the capabilities of a 
user's terminal. Direction: Application to Networ]<: 

In parameter Terminalldentity : Identifies the terminal. It may be 
a logical address ]<:nown by the WAP Gateway/PushProxy . 
Out parameter, see TerminalCapabilityStruct*/ 
void getTerminalCapabilities ( 
in TpString terminalldentity, 
out TpTerminalCapabilities result 
) 



raises (TpTermCapException, TpGeneralException) ; 



};};};}; 
#endif 
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